Soracom Knowledge

com.soracom由 soracom.com 發布官方發布者v1.1.5更新於 Oct 24, 2026

Search SORACOM documentation: service guides, FAQ, API references, IoT recipes, etc.

已驗證Streamable HTTP可網頁執行知識與記憶開發者工具

概覽

AI 產生的概覽

一個託管的唯讀 MCP 端點，讓助理搜尋 SORACOM 文件與 API 參考，並取得完整頁面內容。

可以做什麼
搜尋 SORACOM 服務指南、使用者主控台操作說明、定價、更新日誌與 IoT 案例，支援英文或日文，可選關鍵字、語意或混合模式並依網站過濾。搜尋 API 參考、CLI 指令與 SAM 權限，可依服務標籤、HTTP 方法或路徑片段縮小範圍。取得搜尋結果中頁面或 API schema 連結的完整 Markdown 內容。
適用情境
當助理需要回答關於 SORACOM 服務、使用者主控台、定價、IoT 案例、SORACOM API 端點、soracom-cli 指令或 SAM 權限的問題，並希望答案以官方文件為依據而非只依賴訓練資料時適用。
執行需求
需要支援 Streamable HTTP 的遠端 MCP 用戶端，並指向 SORACOM 的公開端點。不需帳號、API 金鑰或標頭。需要能連線至該端點的網路。
安裝前請注意
沒有依使用者區分的驗證：每次查詢都會送到該端點，在混合或語意模式下還會送到 OpenAI 產生向量，因此不要在查詢中放入機密資訊、帳號識別碼、憑證或個人資料。服務為唯讀，不會修改 SORACOM 資源。結果可能與查詢關聯薄弱，索引更新落後於文件變更；重要資訊請對照原始頁面確認。免費、盡力提供、無 SLA，請求過多可能被限流。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Soracom Knowledge，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.soracom%2Fknowledge/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "soracom-knowledge": {
      "type": "http",
      "url": "https://knowledge-mcp.soracom.com/"
    }
  }
}

README

Soracom Knowledge MCP Server

The Soracom Knowledge MCP Server is an MCP (Model Context Protocol) server that lets AI agents search Soracom documentation and Soracom API references directly from your development environment. When connected to an MCP client such as Claude Code, OpenAI Codex, or Claude Desktop, the agent can look up service guides, Soracom User Console procedures, pricing, IoT recipes, Soracom API references, CLI commands, and SAM permissions on demand, and ground its answers in the official documentation instead of relying only on its training data.

The server is hosted by Soracom as a shared, read-only endpoint. It does not modify any of your Soracom resources—the agent only searches and reads documentation.

Available Tools

The server exposes three read-only tools to the connected agent. None of them modify your account or its resources.

The server's default hybrid search mode combines keyword search with semantic search (using OpenAI embeddings) and merges the results using Reciprocal Rank Fusion (RRF).

search_soracom_docs

Searches Soracom service guides, Soracom User Console procedures, service overviews and pricing, and IoT recipes.

ParameterDescription
queryA natural-language search query (required).
document_namesRestricts the search to specific sites (e.g., ["docs.soracom.io", "users.soracom.io"]). The available sites are listed in the tool schema. Omit it to search all sources.
search_modehybrid (default; combines keyword and semantic search), keyword (keyword search only), or semantic (semantic similarity only).
languageEnglish or Japanese. Auto-detected from the query when omitted.
max_resultsNumber of results to return. Default 16, maximum 32.

search_api_docs

Searches Soracom API references, CLI commands, and SAM permissions.

ParameterDescription
queryA natural-language question or an API endpoint name. Optional when at least one of tag, method, or path is supplied.
tagRestricts results to a service tag (e.g., Sim, Subscriber, Flux). Case-insensitive exact match.
methodRestricts results to an HTTP method (e.g., GET, POST). Case-insensitive exact match.
pathRestricts results to an API path fragment (e.g., /sims). Case-insensitive substring match.
search_modehybrid (default; combines keyword and semantic search), keyword (keyword search only), or semantic (semantic similarity only).
languageEnglish or Japanese. Auto-detected from query when query is provided. If you omit query, specify language explicitly.
max_resultsNumber of results to return. Default 16, maximum 32.

get_document

Fetches the full Markdown of a page returned by search_soracom_docs or search_api_docs.

ParameterDescription
urlThe URL of the page to fetch (required). Pass the url value from a search result verbatim. A search result may return a URL that is not directly viewable in a browser (such as a fragment of a split API reference), but this tool can still fetch its content.

Connecting the Server

The server is reachable at a stable public HTTPS endpoint and uses the MCP Streamable HTTP transport:

text
https://knowledge-mcp.soracom.com

[!WARNING] The server has no per-user authentication. It only searches and returns public Soracom documentation, but any query you enter is sent to the endpoint. With the hybrid or semantic search mode, your query is also sent to OpenAI to generate embeddings. Do not include confidential information, account identifiers, credentials, or personal data in your queries.

For Soracom's terms and privacy practices, see the Terms and Conditions and Privacy Policy. Soracom does not record or retain the content of your queries in its server logs. Soracom also does not share OpenAI API inputs or outputs with OpenAI for model improvement, evaluation, fine-tuning, or training. For details, see OpenAI's Business data privacy, security, and compliance.

Use of this server is subject to our Site Policy (available in Japanese), which includes disclaimers, copyright terms, and provides that use is governed by the laws of Japan, with the Tokyo District Court as the exclusive court of first instance. The Japanese text prevails.

Claude Code

Claude Code supports remote HTTP MCP servers natively. Add the server with the claude mcp add command:

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

Verify that the server is connected:

bash
claude mcp list

The soracom-knowledge server and its three tools are now available in your Claude Code sessions. To remove it later, run claude mcp remove soracom-knowledge.

OpenAI Codex

The Codex CLI supports remote MCP servers over HTTP. Add the server with:

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

List configured servers to confirm:

bash
codex mcp list

Notes and Limitations

  • This server is provided free of charge on a best-effort basis and without an SLA. Its specifications may change without notice as the service is improved.
  • Access may be temporarily restricted if an excessive number of requests are detected.
  • A result set may include pages that are only loosely related to your query. The agent is expected to filter these; treat individual hits as candidates rather than authoritative matches.
  • The information returned by this server is provided "AS-IS", and answers generated by an AI agent are not guaranteed to be accurate. Verify important details against the linked source pages.
  • The search index is updated periodically, so it may take some time for changes to the public documentation to be reflected in search results.

This page mirrors the official documentation: English | Japanese. Registry: com.soracom/knowledge on the Official MCP Registry.

來源：servers/knowledge/README.md，提交 081b555

工具

3

get_document

Get Full SORACOM Documentation Page

Fetch full markdown for a SORACOM documentation page. Also resolves API schema links. Exact URLs are attempted first.

輸入參數url必填

search_api_docs

Search SORACOM API Documentation

Search SORACOM API documentation, CLI references, and SAM permissions. Use for exact API endpoints, soracom-cli commands, or SAM permission strings. Use search_soracom_docs for service guides, console how-tos, pricing, or IoT recipes. Use get_document on `#/schema/<Name>` links in results to read full API schema fields.

輸入參數tagpathquerymethodlanguagemax_resultssearch_mode

search_soracom_docs

Search SORACOM Documentation

Search SORACOM service documentation, guides, and console how-to articles (user site, service overviews and pricing, IoT recipes). Covers SORACOM services, subscription plans, User Console operations, changelogs, blogs, devices, IoT Store, partners, contract terms, and use cases. Use search_api_docs for API references, CLI commands, or SAM permissions.

輸入參數query必填marketlanguagemax_resultssearch_modedocument_names

版本歷史

2
  1. v1.1.5最新Oct 8, 2026
  2. v1.1.4Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分