iletiMerkezi MCP サーバー

iletiMerkezi SMS API 用の Model Context Protocol サーバーです。MCP 対応の LLM クライアント（Claude Code、Cursor、Codex CLI、Gemini CLI、VS Code+Cline、Claude Desktop など）から、ツール呼び出しを通じて SMS の送信、配信レポートの照会、送信者/ブラックリストの管理を行えます。

iletiMerkezi は、トルコの BTK ライセンスを取得した一括 SMS / OTP / A2P プラットフォームです。ツールの形状（入力スキーマ、説明、ドキュメントリンク）は、公式のエンドポイントドキュメントから構築された標準の API マニフェスト から派生しているため、このサーバーは設計上、ライブ API と常に同期しています。

ツール

Related MCP server: Promotexter MCP Server

インストール

5つのクライアントは同じ JSON mcpServers スキーマを共有しています。Claude Code と Codex CLI は1行の CLI コマンドも公開しています。以下のクライアントから選択してください。

クライアント → 設定ファイル

共有 JSON 設定 (Claude Code, Cursor, Gemini CLI, VS Code+Cline, Claude Desktop)

関連する設定ファイルに以下のブロックを追加してください：

{
  "mcpServers": {
    "iletimerkezi": {
      "command": "npx",
      "args": ["-y", "@iletimerkezi/mcp-server"],
      "env": {
        "ILETIMERKEZI_API_KEY": "your-api-key",
        "ILETIMERKEZI_API_HASH": "your-api-hash"
      }
    }
  }
}

クライアントを完全に終了し、再起動してください。11個のツールが iletimerkezi サーバーの下に表示されます。

Claude Code — 単一コマンド

ユーザースコープ（すべてのプロジェクトで利用可能）：

claude mcp add iletimerkezi -s user \
  -e ILETIMERKEZI_API_KEY=your-api-key \
  -e ILETIMERKEZI_API_HASH=your-api-hash \
  -- npx -y @iletimerkezi/mcp-server

現在の Claude Code セッションを閉じ、新しいセッションを開始してください。ツールは mcp__iletimerkezi__* として表示されます。削除するには claude mcp remove iletimerkezi -s user を実行してください。

Codex CLI — TOML 形式

CLI 経由：

codex mcp add iletimerkezi \
  --env ILETIMERKEZI_API_KEY=your-api-key \
  --env ILETIMERKEZI_API_HASH=your-api-hash \
  -- npx -y @iletimerkezi/mcp-server

または ~/.codex/config.toml を直接編集：

[mcp_servers.iletimerkezi]
command = "npx"
args = ["-y", "@iletimerkezi/mcp-server"]

[mcp_servers.iletimerkezi.env]
ILETIMERKEZI_API_KEY = "your-api-key"
ILETIMERKEZI_API_HASH = "your-api-hash"

検証

初回使用時に get_balance と get_sender を試してください。どちらも読み取り専用であり、クレジットを消費しません。

ホスト型クライアント (ChatGPT Apps, Gemini App, Claude Web Connectors)

これらのクライアントは リモート MCP (HTTPS エンドポイント) を必要とし、ローカルの npx コマンドを生成しません。このサーバーは現在 stdio (ローカル) モードでのみ提供されています。ホスト型サポートはロードマップに含まれています。

認証情報

両方の値は panel.iletimerkezi.com → Settings → Security → API Access から取得できます。そのままコピーしてください。自分でハッシュ化しないでください。パネルが事前計算されたハッシュを発行します。

また、Settings → Security → Access Permissions で Allow API access を有効にする必要があります。そうしないと、すべての呼び出しで 401 が返されます。これは最も一般的なオンボーディングの落とし穴です。サーバーの 401 エラーメッセージはこのトグルを指し示します。

完全な認証契約については https://www.iletimerkezi.com/docs/api/authentication を参照してください。

ツールの形状を最新に保つ方法

起動時にサーバーは以下の順序で試行します：

1. ~/.cache/iletimerkezi-mcp/manifest.json にある ローカルキャッシュ（24時間有効）。

2. https://www.iletimerkezi.com/api/manifest.json の ライブフェッチ（5秒タイムアウト）。成功するとキャッシュをアトミックに更新します。

3. npm パッケージに同梱されている ビルド時フォールバック (dist/manifest.fallback.json) — npm publish 時のマニフェストスナップショット。

つまり、マニフェストに公開された新しいエンドポイントやスキーマの変更は、npm update を必要とせず、24時間以内に実行中のクライアントに反映されます。このリポジトリには 手書きのツールスキーマは存在しません。API ドキュメントが唯一の信頼できる情報源です。

ステージング環境やプレビュー環境では、ILETIMERKEZI_MANIFEST_URL でマニフェスト URL を上書きできます。

ローカル開発

npm install
npm run build
npm test

シェルで認証情報を設定し、ライブ API に対してサーバーのスモークテストを行います：

ILETIMERKEZI_API_KEY=... ILETIMERKEZI_API_HASH=... node dist/index.js

これは stdio を介して MCP で通信します。MCP クライアントを使用して対話するか、デバッグ用に JSON-RPC ハンドシェイクを手動でパイプしてください。

リファレンス

• MCP セットアップガイド: https://www.iletimerkezi.com/docs/mcp (TR) · /en/docs/mcp (EN)

• 概要: https://www.iletimerkezi.com/docs/api/overview

• 認証: https://www.iletimerkezi.com/docs/api/authentication

• エラーコード: https://www.iletimerkezi.com/docs/api/error-codes

• マニフェスト (機械可読): https://www.iletimerkezi.com/api/manifest.json

• リリースノート: CHANGELOG.md

ライセンス

MIT — LICENSE を参照してください。