MCP 連携ガイド

MCP とは

MCP（Model Context Protocol）は、AI アシスタントが外部のサービスを道具として使うための共通規格です。chiyo-co は MCP に対応しているため、Claude などの AI アシスタントとの会話の中から、そのままコピペチェックを実行できます。

できるようになることの例です。

• AI に書かせた原稿を、画面を移動せずにその場でチェックする
• 「この記事のコピペチェックをして、結果を要約して」と頼むだけで、投入から結果の読み解きまで任せる
• 複数の原稿をまとめてチェックし、点数の高いものだけ詳しく見る

接続情報

接続に必要なものは次の 2 つです。

• エンドポイント URL
  https://kagemusya.biz-samurai.com/mcp（Streamable HTTP 方式）
• API キー
  ログイン後、アカウントメニューの「MCP 接続」ページから発行します

API キーの取得手順

• chiyo-co にログインし、画面右上のアカウントメニューから「MCP 接続」を開きます
• キーの名前（例:「自宅PC用」「CI用」）を入力し、許可する操作を選びます。
  解析結果の参照のみを許可したキーでは、解析の投入（カウント消費）はできません。用途に応じて必要最小限を選んでください。
• 必要に応じて有効期限（30 / 90 / 180 / 365 日）を設定できます。既定は無期限です。期限を過ぎたキーは自動的に使えなくなります（延長はできないため、必要な場合は新しいキーを発行してください）。
  ※CI など一時的な用途では期限を設定することをおすすめします。
• 「発行する」を押すとキーが表示されます。※キーの全体が表示されるのはこのときだけです。パスワード管理ソフトなど安全な場所に保管してください。
• キーが漏れた場合や使わなくなった場合は、同じページからいつでも失効できます。失効は即時に反映されます。

クライアント別の設定方法

お使いの AI クライアントに合わせて、以下の設定を行ってください。<YOUR_API_KEY> は発行した API キーに置き換えます。

Claude Code

ターミナルで次のコマンドを実行します。

claude mcp add --transport http chiyoco https://kagemusya.biz-samurai.com/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"

Cursor

~/.cursor/mcp.json（プロジェクト単位なら .cursor/mcp.json）に追記します。

{
  "mcpServers": {
    "chiyoco": {
      "url": "https://kagemusya.biz-samurai.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

VS Code（GitHub Copilot Chat）

ワークスペースの .vscode/mcp.json に追記します。

{
  "servers": {
    "chiyoco": {
      "type": "http",
      "url": "https://kagemusya.biz-samurai.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

Gemini CLI

~/.gemini/settings.json（プロジェクト単位なら .gemini/settings.json）に追記します。URL のキーが url ではなく httpUrl である点にご注意ください。

{
  "mcpServers": {
    "chiyoco": {
      "httpUrl": "https://kagemusya.biz-samurai.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

キーを設定ファイルに直接書きたくない場合は、環境変数を参照できます。CHIYOCO_API_KEY に API キーを設定したうえで次のように書きます。

{
  "mcpServers": {
    "chiyoco": {
      "httpUrl": "https://kagemusya.biz-samurai.com/mcp",
      "headers": {
        "Authorization": "Bearer ${CHIYOCO_API_KEY}"
      }
    }
  }
}

その他のクライアント

Streamable HTTP に対応し、任意の HTTP ヘッダを設定できるクライアントであれば同じ方法で接続できます。Authorization ヘッダに Bearer <YOUR_API_KEY> を指定してください。

スクリプトや CI から使う

MCP クライアントを介さず、シェルスクリプトや CI から直接呼び出すこともできます。手順はHTTP から直接呼び出す（ベータ）をご覧ください。※プロトコルの通信内容を直接扱うため、ベータ扱いとしています。継続的なご利用には上記のクライアントを推奨します。

クライアント対応表

API キー（Authorization ヘッダ）方式での接続可否です。※各クライアントの仕様に基づく可否です。バージョンによって設定方法が変わることがあります。

クライアント	接続	備考
Claude Code	○	--header でキーを指定
Cursor	○	mcp.json の headers
VS Code（Copilot Chat）	○	.vscode/mcp.json の headers
Gemini CLI	○	settings.json の httpUrl と headers
Claude Desktop	△	カスタムコネクタの「リクエストヘッダ」欄で設定（提供状況はバージョンによる）
claude.ai（Web 版）	△	同上
ChatGPT コネクタ	×	API キーを提示できない仕様のため非対応

できること（公開ツール）

接続すると、AI から次の 5 つの操作が使えるようになります。実際には AI が会話の内容に応じて選んで実行するため、利用者がツール名を意識する必要はありません。

解析の実行

• chiyoco_run_check（要: 解析の投入）
  テキストを投入して解析を開始します。結果はすぐには返らず、解析 ID が返ります。
  指定できる内容: 対象テキスト（空白を除いて 51〜20,000 文字）／チェック種別／履歴用のタイトル（任意）／消費してよいカウントの上限。
  ※チェック種別は「コピペチェックのみ」と「コピペチェックに加えて類似チェックも行う」の 2 つで、管理画面の「類似チェック」の有無と同じものです。類似チェックを行う場合はカウント消費が 2 倍になります。
  ※上限を 0 にすると、カウントを消費せずに「何カウント必要か」だけを確認できます。

結果の参照

• chiyoco_get_status（要: 結果の参照）
  解析の進行状況（投入待ち・解析中・完了・失敗など）を確認します。
• chiyoco_get_result（要: 結果の参照）
  完了した解析の結果を取得します。総合評価などの要約と、検出されたサイトごとの詳細（一致箇所の本文を含む）を選べます。
• chiyoco_list_analyses（要: 結果の参照）
  過去の解析を新しい順に一覧します。状態や種別で絞り込めます。
• chiyoco_get_quota（要: 結果の参照）
  今月のカウントの付与数・消費数・残数を確認します。解析は実行しないため、カウントは消費しません。

使い方の例

接続後は、次のように普通の言葉で頼むだけです。

• 「いま書いた記事を chiyo-co でコピペチェックして。3 カウントまでなら使っていいよ」
• 「さっきの解析、終わった？結果を要約して教えて」
• 「今週チェックした原稿の一覧を出して、重複度が高いものだけ詳しく見せて」
• 「今月あと何カウント残ってる？足りそうならこの記事もチェックして」

うまく接続できないとき

• 認証エラーになる
  キーが正しくコピーされているか、失効・期限切れになっていないかを「MCP 接続」ページでご確認ください。キーの前後に空白が入っていないかもご確認ください。
• 解析の実行だけができない
  そのキーに「解析の投入」が許可されていない可能性があります。「MCP 接続」ページでキーの許可内容をご確認ください。
• 「カウントが足りない」と言われる
  今月の残りカウントが不足しています。残りは AI に「今月あと何カウント残ってる？」と聞けば確認できます。追加が必要な場合は料金プランをご確認ください。
• 短時間に何度も実行するとエラーになる
  サービス保護のため呼び出し回数に上限を設けています。しばらく待ってから再度お試しください。

解決しない場合はお問い合わせよりご連絡ください。