AIエージェント連携（MCP）

調整くんは、Claudeなどの対応するAIエージェントから直接イベントを作成・確認・操作できる、MCP (Model Context Protocol) サーバーを備えています。エージェントに接続を追加すると、「来週の候補日を作って」 「◯◯さんの回答状況を教えて」といった会話だけで、調整くんを操作できるようになります。

できること

接続すると、AIエージェントから次の操作ができるようになります。「管理者操作」は、イベント作成時に設定した 管理者パスワードを伝えたときだけ実行できます。

  • create_event候補日程を指定して、新しい日程調整イベントを作成する
  • list_my_events自分がこれまでに作成したイベントの一覧を取得する
  • get_eventイベントの内容や、参加者の回答状況を確認する
  • participate_in_eventイベントに出欠を登録したり、既に送った回答を修正したりする
  • admin_confirm_candidate（管理者操作）候補日程の中から開催日を確定する
  • admin_duplicate_event（管理者操作）既存のイベントを複製して新しいイベントを作る
  • admin_export_csv（管理者操作）参加者の回答結果をCSV形式で取り出す
  • admin_update_results_visibility（管理者操作）回答結果を参加者全員に公開するかどうかを設定する

Claude Codeで追加する

ターミナルで次のコマンドを実行すると、Claude Codeにこのサーバーが登録されます。

claude mcp add --transport http chousei-kun https://example.com/api/mcp

登録後は claude mcp list で接続状態を確認できます。

Claude Desktopなど他のMCPクライアントで追加する

設定ファイルからリモートMCPサーバーを追加できるクライアントでは、サーバー名は任意のもの（例: chousei-kun）、通信方式は HTTP、接続先には次のURLを指定してください。追加のログインやAPIキーは不要です。

https://example.com/api/mcp

セキュリティについて

MCP経由の操作は、調整くん本体と同じ仕組みで行われます。専用のアカウントやログインは無く、 誰でもこのURLに接続してイベントを作成したり回答したりできます。管理者操作（開催日の確定・複製・ CSV出力・公開設定の変更）だけは、そのイベント作成時に設定した管理者パスワードを伝えたときに限って 実行されます。管理者パスワードは、Webの管理画面にログインするときと同じように、信頼できる相手・ エージェントにしか伝えないようにしてください。

配布用Skillについて

リポジトリの skills/chousei-kun/ には、上記のツールの使い方（候補日程の入力形式や管理者パスワードの扱い方など）をAIエージェントに あらかじめ伝えておくためのSkillファイルが同梱されています。お使いの環境の Skillsフォルダ（Claude Codeであれば ~/.claude/skills/） にこのフォルダをコピーしておくと、より的確にツールを使ってもらえるようになります。

トップへ戻る