Soracom Knowledge

Soracom Knowledge MCP Server

Soracom Knowledge MCP Server は、開発環境から Soracom のドキュメントや Soracom API リファレンスを直接検索できる MCP（Model Context Protocol） サーバーです。Claude Code、OpenAI Codex、Claude Desktop などの MCP クライアントに接続すると、エージェントはサービスガイド、Soracom User Console の手順、料金、IoT レシピ、Soracom API リファレンス、CLI コマンド、SAM 権限を必要に応じて検索し、学習データだけに頼らず公式ドキュメントに基づいた回答を提供できます。

このサーバーは、共有の読み取り専用エンドポイントとして Soracom がホストしています。Soracom のリソースを変更することはありません。エージェントが行うのは、ドキュメントの検索と読み取りだけです。

利用可能なツール

このサーバーは、接続されたエージェントに読み取り専用のツールを 3 つ提供します。いずれもアカウントやリソースを変更することはありません。

サーバーのデフォルトの hybrid 検索モードでは、キーワード検索と（OpenAI の埋め込みを使った）セマンティック検索を組み合わせ、Reciprocal Rank Fusion（RRF）を使用して検索結果を統合します。

search_soracom_docs

Soracom のサービスガイド、Soracom User Console の手順、サービス概要と料金、IoT レシピを検索します。

パラメーター	説明
query	自然言語の検索クエリ（必須）。
document_names	検索対象を特定のサイトに限定します（例：["docs.soracom.io", "users.soracom.io"]）。利用可能なサイトはツールのスキーマに記載されています。省略すると、すべてのソースを検索します。
search_mode	hybrid（デフォルト。キーワード検索とセマンティック検索を組み合わせる）、keyword（キーワード検索のみ）、または semantic（セマンティック類似度検索のみ）。
language	English または Japanese。省略すると、クエリから自動検出されます。
max_results	返す検索結果の数。デフォルトは 16、最大は 32 です。

search_api_docs

Soracom API リファレンス、CLI コマンド、SAM 権限を検索します。

パラメーター	説明
query	自然言語の質問または API エンドポイント名。tag、method、path のいずれかが指定されている場合は省略可能です。
tag	サービスのタグに検索対象を限定します（例：Sim、Subscriber、Flux）。大文字と小文字を区別しない完全一致です。
method	HTTP メソッドに検索対象を限定します（例：GET、POST）。大文字と小文字を区別しない完全一致です。
path	API パスの一部に検索対象を限定します（例：/sims）。大文字と小文字を区別しない部分一致です。
search_mode	hybrid（デフォルト。キーワード検索とセマンティック検索を組み合わせる）、keyword（キーワード検索のみ）、または semantic（セマンティック類似度検索のみ）。
language	English または Japanese。query が指定されている場合は、query から自動検出されます。query を省略する場合は、language を明示的に指定してください。
max_results	返す検索結果の数。デフォルトは 16、最大は 32 です。

get_document

search_soracom_docs または search_api_docs が返したページの Markdown 全文を取得します。

パラメーター	説明
url	取得するページの URL（必須）。検索結果の url 値をそのまま渡してください。検索結果には、ブラウザーで直接表示できない URL（分割された API リファレンスの一部など）が含まれる場合がありますが、このツールではその内容を取得できます。

サーバーへの接続

サーバーは安定したパブリック HTTPS エンドポイントで利用でき、MCP Streamable HTTP トランスポートを使用します。

https://knowledge-mcp.soracom.com

警告

サーバーにはユーザーごとの認証機能がありません。パブリックな Soracom ドキュメントのみを検索して返しますが、入力したクエリはすべてエンドポイントに送信されます。hybrid または semantic の検索モードでは、埋め込みを生成するためにクエリが OpenAI にも送信されます。クエリには、機密情報、アカウント識別子、認証情報、個人データを含めないでください。

Soracom の利用規約とプライバシーに関する取り組みについては、利用規約およびプライバシーポリシーをご覧ください。Soracom は、クエリの内容をサーバーログに記録または保持しません。また、モデルの改善、評価、ファインチューニング、トレーニングを目的として、OpenAI API の入力や出力を OpenAI と共有することもありません。詳しくは、OpenAI のビジネスデータに関するプライバシー、セキュリティ、コンプライアンスをご覧ください。

このサーバーの利用にはサイトポリシー（日本語）が適用されます。このポリシーには免責事項と著作権に関する条項が含まれており、日本の法律が適用され、東京地方裁判所が第一審の専属的合意管轄裁判所となることが定められています。日本語の本文が優先されます。

Claude Code

Claude Code は、リモート HTTP MCP サーバーを標準でサポートしています。claude mcp add コマンドでサーバーを追加します。

claude mcp add --transport http soracom-knowledge https://knowledge-mcp.soracom.com

サーバーが接続されていることを確認します。

claude mcp list

これで、soracom-knowledge サーバーとその 3 つのツールを Claude Code のセッションで利用できます。後で削除するには、claude mcp remove soracom-knowledge を実行します。

OpenAI Codex

Codex CLI は、HTTP 経由のリモート MCP サーバーをサポートしています。次のコマンドでサーバーを追加します。

codex mcp add soracom-knowledge --url https://knowledge-mcp.soracom.com

設定済みのサーバーを一覧表示して確認します。

codex mcp list

注意事項と制限

• このサーバーは、ベストエフォートで SLA なしの無償サービスとして提供されます。サービスの改善に伴い、仕様が予告なく変更される場合があります。
• 過剰な数のリクエストが検出された場合、一時的にアクセスが制限されることがあります。
• 検索結果に、クエリとの関連性が低いページが含まれる場合があります。エージェントがこれらを絞り込むことを想定しているため、個々の検索結果は確定的な一致ではなく、候補として扱ってください。
• このサーバーが返す情報は「現状有姿」で提供され、AI エージェントが生成する回答の正確性は保証されません。重要な詳細は、リンク先のソースページで確認してください。
• 検索インデックスは定期的に更新されるため、パブリックドキュメントの変更が検索結果に反映されるまで時間がかかる場合があります。

---

このページは公式ドキュメントを反映しています：英語 | 日本語。レジストリ：Official MCP Registry の com.soracom/knowledge。