HTTP から直接呼び出す（ベータ）

こんなときに

MCP クライアントを介さず、シェルスクリプトや CI から直接解析を投入したい場合の手順です。

• CI のパイプラインで、記事の公開前に自動でコピペチェックをかけたい
• 社内ツールから chiyo-co を呼び出したい
• MCP に対応していない環境から使いたい

API キーはMCP 接続の画面で発行したものをそのまま使えます。消費するカウントも画面から実行する場合と同じです。

通信の形式

エンドポイントは 1 つで、すべての操作を POST で送ります。

https://kagemusya.biz-samurai.com/mcp

本文は JSON-RPC 2.0 形式です。送るヘッダは次の 3 つです（必須は Authorization と Content-Type の 2 つ）。

解析を投入する

もっとも短い例です。<YOUR_API_KEY> は発行したキーに置き換えてください。

curl -X POST https://kagemusya.biz-samurai.com/mcp \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "chiyoco_run_check",
      "arguments": {
        "text": "チェックしたい本文をここに入れます。この例文は空白と改行を除いて 51 文字以上になるように書いてあるので、そのまま実行して動作を確かめられます。",
        "check_type": "kagemusha",
        "idempotency_key": "ci-20260731-001",
        "max_ticket_cost": 10
      }
    }
  }'

成功すると次のような応答が返ります。

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "analytic_id": 671,
      "status": "running",
      "ticket_cost": 1,
      "tickets_remaining": 967
    },
    "content": [{ "type": "text", "text": "{\"analytic_id\":671,...}" }]
  }
}

引数の決まり

状態を確認する

解析は非同期で、数分から数十分かかります。chiyoco_get_status で確認します。

curl -X POST https://kagemusya.biz-samurai.com/mcp \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "chiyoco_get_status",
      "arguments": { "analytic_id": 671 }
    }
  }'

status が succeeded になったら結果を取得できます。※確認の間隔は 30 秒以上を空けてください。

結果を取得する

curl -X POST https://kagemusya.biz-samurai.com/mcp \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "chiyoco_get_result",
      "arguments": { "analytic_id": 671, "detail": "summary" }
    }
  }'

detail に summary を指定すると全体のスコアと上位のターゲットが返ります。一致した箇所の詳細が必要な場合は markers を指定してください（応答が大きくなるためページングされます）。

残りカウントを確認する

今月のカウントの付与数・消費数・残数は chiyoco_get_quota で取得できます。引数はありません。

curl -X POST https://kagemusya.biz-samurai.com/mcp \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
      "name": "chiyoco_get_quota",
      "arguments": {}
    }
  }'

次のような応答が返ります。

{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "structuredContent": {
      "plan_name": "スタンダードプラン",
      "plan_tickets": 1000,
      "tickets_granted": 1000,
      "tickets_added": 0,
      "tickets_consumed": 33,
      "tickets_remaining": 967
    },
    "content": [{ "type": "text", "text": "{\"plan_name\":\"スタンダードプラン\",...}" }]
  }
}

カウントは毎月 1 日にリセットされ、前月分は繰り越されません。※超過利用が可能な契約では tickets_remaining が負の値になることがあります。

使えるツールを調べる

利用できる操作の一覧と、それぞれの引数の形式は tools/list で取得できます。

curl -X POST https://kagemusya.biz-samurai.com/mcp \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":5,"method":"tools/list","params":{}}'

API キーに与えたスコープによって、返るツールが変わります。「解析結果の参照」のみを許可したキーでは chiyoco_run_check は含まれません。

エラーへの対処

{
  "jsonrpc": "2.0",
  "id": 21,
  "result": {
    "content": [{
      "type": "text",
      "text": "{\"error\":{\"code\":\"rate_limited\",\"message\":\"...\",\"retryable\":true,\"details\":{\"retry_after\":31,\"scope\":\"key\"}}}"
    }],
    "isError": true
  }
}

お問い合わせ

ご不明な点はお問い合わせよりご連絡ください。MCP 連携ガイドもあわせてご覧ください。