MCP接続ガイド
エンドポイント
Section titled “エンドポイント”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 |
クライアントをつなぐ
Section titled “クライアントをつなぐ”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の適合性テストで、エンドポイントを確かめました(信頼性と透明性)。上のクライアントごとの手順は、各クライアントの公式の設定方法に沿ったもので、すべてのクライアントで自分たちが試したわけではありません。
13のツール
Section titled “13のツール”入力の詳細はツール一覧にあります。概要は次のとおりです。
| 分類 | ツール |
|---|---|
| 暦 | 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で決まります。定義にない項目は断ります。
呼び出し:
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "to_japanese_era", "arguments": { "date": "2019-05-01" } }}成功した結果は、答えの形を2か所に持ちます:content[0].text のJSON文字列と、structuredContent のオブジェクトです。
{ "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