Sinch Docs MCP Server

Sinch Docs MCP Server とは？

Sinch Docs MCP Server は、developers.sinch.com/mcp でホストされる Sinch 公式のドキュメント MCP サーバーで、AI コーディングアシスタントが Sinch のドキュメントを検索し、API 定義を読んで連携コードを書けるようにします。API キーは不要で、サーバー自身が Sinch API を呼び出すことはありません。

Sinch はコミュニケーションプラットフォームで、Conversation API を通じた SMS、WhatsApp、RCS などのチャネルに加え、音声通話、電話番号、認証、番号照会、FAX、SIP トランキングの API を提供しています。Sinch は各 API の「AI best practices」ページでこの MCP サーバーを紹介しており、llms.txt のインデックスや全ページの Markdown 版もあわせて提供しています。

Sinch Docs MCP Server の使い方

インストールは不要です。リモートの Streamable HTTP サーバーに対応した MCP クライアントに、次の URL を追加します。

https://developers.sinch.com/mcp

私たちのプローブは認証情報なしで接続できました。Sinch のガイドでは、クライアントによってはログインを求められる場合があるとしています。その場合は手順に従って完了してください。Sinch の API キーは関係ありません。

Claude Code

Sinch のドキュメントに記載されているコマンドです。サーバー名は自由に付けられます。

claude mcp add --transport http sinch-docs https://developers.sinch.com/mcp

その後、Claude Code で /mcp と入力し、サーバーとツールが表示されることを確認します。

Claude Desktop と claude.ai

Settings > Connectors を開き、Add custom connector を選んで名前を「Sinch Docs」とし、https://developers.sinch.com/mcp を貼り付けます。

Cursor

コマンドパレットを開いて「Open MCP settings」を実行し、「Add custom MCP」を選んで、Sinch のガイドにある設定を追加します。

{
  "mcpServers": {
    "sinch-mcp": {
      "url": "https://developers.sinch.com/mcp"
    }
  }
}

VS Code

コマンドパレットから「MCP: Add Server」を実行し、「HTTP」を選んで URL と名前を入力します。または .vscode/mcp.json に追加します。

{
  "servers": {
    "sinch-docs": {
      "type": "http",
      "url": "https://developers.sinch.com/mcp"
    }
  }
}

Sinch Docs MCP Server の主な機能

• Sinch が公式に案内しているサーバー。無料でキー不要。
• ドキュメント専用：Sinch は、見つけたエンドポイントをこのサーバーが呼び出すことはないと明言しています。生成されたコードは自分のプロジェクトに組み込み、自分の認証情報で使います。
• コードサンプルを含む Sinch 開発者ドキュメント全体を検索。
• Conversation API、Voice API と Voice API v2、Numbers、Number Lookup、Verification、Fax、Elastic SIP Trunk、Provisioning、10DLC 登録、Access Keys、Subprojects など、20 以上の OpenAPI 定義への構造化アクセス。
• エンドポイントの照会で、パラメーター、例、セキュリティ要件、サーバー URL を取得。
• Sinch が公開しているエージェントスキル（npx skills add sinch/skills）と組み合わせると、コーディングツールでさらにガイダンスが得られる。

Sinch Docs MCP Server のツール

私たちのプローブでは、一連のドキュメント関数をラップする 2 つの MCP ツールが返されました。

• describe-tools はサンドボックス関数の正確な TypeScript シグネチャを返し、アシスタントがパラメーターを推測せずに済むようにします。
• execute は、唯一のグローバルが tools でネットワークアクセスのないサンドボックスで JavaScript を実行します。アシスタントはこれを通じて次を呼び出します。
  • listApis でドキュメント化された API を一覧表示し、getEndpoints で 1 つの API のパスとメソッドを一覧表示。
  • getEndpointInfo で 1 つのエンドポイントの詳細を、getSecuritySchemes でその認証を取得。
  • getFullApiDescription で完全な OpenAPI ドキュメントを取得。
  • search で関連するドキュメント内容を検索。
  • submitFeedback で誤りや不足のあるページを報告。

Sinch のガイドでは、これらの関数がハイフン区切りの名前（list-apis や get-endpoint-info など）を持つ個別のツールとして記載されています。現在のサーバーは execute を通じて提供しているため、クライアントには上記の 2 つのツールだけが表示されます。

Sinch Docs MCP Server のユースケース

• メッセージ送信：「Sinch のドキュメントに基づいて、Conversation API で SMS を送る Node.js のコードを書いて」
• 音声：「発信通話を開始する Voice API のエンドポイントはどれで、どんなパラメーターが必要？」
• 認証：「Verification API で SMS 認証を開始する方法を教えて」
• 電話番号：「Numbers API で電話番号を検索・有効化するエンドポイントを一覧にして」
• 米国のコンプライアンス：「10DLC のブランドとキャンペーンを登録する手順は？」

Sinch Docs MCP Server のトラブルシューティング

• 不明な関数としてツール呼び出しが失敗する： まず describe-tools を実行させ、返された正確な名前を使うよう指示してください。
• 古い API バージョンに基づいた回答になる： 複数の定義が同じタイトルを共有しています（Number Lookup v1 と v2 など）。バージョンを指定するか、listApis が返す filePath を渡してください。
• 生成されたコードが Sinch で失敗する： このサーバーはドキュメントを読むだけです。プロジェクトの認証情報とリージョンを確認し、Sinch の推奨どおりドキュメントと照らし合わせてコードを見直してください。