本文へ移動

MCP接続ガイド

https://biz.ossalt.jp/mcp

サーバーは Streamable HTTP の、いちばん簡単な形で動きます。JSON-RPC 2.0 のメッセージを1つ POST すると、JSONの答えが1つ返ります。

項目 内容
認証 なし
プロトコルの版 2025-06-18、2025-03-26、2024-11-05(initialize で合わせます)
機能(capabilities) tools のみ(resources・prompts・logging・sampling・elicitation はありません)
セッション 持ちません(セッションIDを発行しません)
ストリーミング 使いません。GET /mcp は 405 で、SSEのストリームはありません
バッチ 非対応。JSONの配列は -32600 で断ります
ブラウザから CORSはすべてのオリジンを許可。許可するリクエストヘッダーは content-type・accept・mcp-protocol-version

URLを、リモート(Streamable HTTP)のMCPサーバーとして追加します。メニューの名前は版によって変わるので、表示が違うときは、各クライアントの説明を見てください。

クライアント 方法
Claude(カスタムコネクタ) コネクタの設定でカスタムコネクタを追加し、上のURLを入れます。
Claude Code claude mcp add --transport http jp-biz-tools https://biz.ossalt.jp/mcp
Cursor mcp.json に {"mcpServers": {"jp-biz-tools": {"url": "https://biz.ossalt.jp/mcp"}}}
VS Code .vscode/mcp.json に {"servers": {"jp-biz-tools": {"type": "http", "url": "https://biz.ossalt.jp/mcp"}}}
MCP Inspector npx @modelcontextprotocol/inspector --cli https://biz.ossalt.jp/mcp --transport http --method tools/list
stdio だけのクライアント npx mcp-remote https://biz.ossalt.jp/mcp でつなぎます

確認したこと。 MCP Inspector のCLIと、MCPの適合性テストで、エンドポイントを確かめました(信頼性と透明性)。上のクライアントごとの手順は、各クライアントの公式の設定方法に沿ったもので、すべてのクライアントで自分たちが試したわけではありません。

入力の詳細はツール一覧にあります。概要は次のとおりです。

分類 ツール
暦 list_holidays、check_business_day、add_business_days、count_business_days、adjust_to_business_day、last_business_day_of_month
和暦 to_japanese_era、from_japanese_era
郵便番号・住所 lookup_postal_code、search_postal_code、normalize_address
法人 lookup_corporate_number、search_corporation_by_name

すべてのツールが readOnlyHint: true と idempotentHint: true を宣言していて、outputSchema は宣言していません。入力は、tools/list で受け取るJSON Schemaで決まります。定義にない項目は断ります。

呼び出し:

tools/call のリクエスト
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": { "name": "to_japanese_era", "arguments": { "date": "2019-05-01" } }
}

成功した結果は、答えの形を2か所に持ちます:content[0].text のJSON文字列と、structuredContent のオブジェクトです。

tools/call のレスポンス
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [{ "type": "text", "text": "{\"result\":{…},\"source\":{…},\"as_of\":\"…\",\"notes\":[],\"flags\":[]}" }],
"structuredContent": { "result": {}, "source": {}, "as_of": "YYYY-MM-DD", "notes": [], "flags": [] }
}
}
状況 返るもの
入力の誤り(日付の形、範囲の外の数、定義にない項目) isError: true の通常の結果。文は Invalid input で始まり、理由が日本語で続きます。
サーバーやデータが使えない isError: true の通常の結果。文は Server error で始まります。あとでもう一度お試しください。
知らないツール JSON-RPCのエラー -32602
知らないメソッド JSON-RPCのエラー -32601
JSONの形が壊れている JSON-RPCのエラー -32700
バッチの配列、または1つのJSON-RPCメッセージでないもの HTTP 400、JSON-RPCのエラー -32600
呼び出しが多すぎる HTTP 429、JSON-RPCのエラー -32000。data.type は "rate_limited"、data.retry_after(秒)つき

isError は、入力の誤りとデータが使えないときの合図です。何も見つからなかったときは、not_found の印が付いた、通常の答えを返します。

  • 呼び出しは、送信元のIPアドレスごとに、1分に60回ほどまでです(Cloudflareの拠点ごとの数え方なので、おおよそです)。MCPのエンドポイントには、ネットワークの端での短い間隔の制限も加えてあります。公開のエンドポイントで、まとめての処理はしないでください。
  • リクエストの本文は64KBまで、文字列の項目は200文字までです。
  • count_business_days は3,660日まで、add_business_days は±2,000日まで、年は1980〜2099です。
  • 稼働の保証(SLA)はありません。

データの出典・新しさ・既知の制限は、信頼性と透明性をご覧ください。

運営:Momonga