# かんぱいさん (kanpaisan) > 飲み会の企画・日程調整・お店投票・決定事項の共有をする Web サービス。ログイン不要。 > 日時はすべて日本時間("2026-10-20 19:00" の形で渡せる)。 ## 使い方の流れ 1. 幹事: POST https://kanpaisan.kanpaisan-server.workers.dev/api/events に title と日程候補(dates)・お店候補(venues)を送る → id, url, adminToken が返る 2. 参加者に url を共有する(Web でも API でも回答できる) 3. 参加者: POST /api/events/{id}/participants に name, answers({日程ID: "ok"|"maybe"|"ng"}), votes([お店ID]) → editToken が返る 4. 幹事: GET /api/events/{id} の summary.bestDateIds / topVenueIds を見て POST /api/events/{id}/decide 5. 決定後の GET /api/events/{id} の decision に announcement(案内文), icsUrl, googleCalendarUrl が入る ## MCP(AI エージェントから使う) - リモート MCP: https://kanpaisan.kanpaisan-server.workers.dev/mcp(Streamable HTTP、インストール不要) - Claude Code: claude mcp add --transport http kanpaisan https://kanpaisan.kanpaisan-server.workers.dev/mcp - サーバーは何も覚えないので、権限は URL で渡す - 幹事の操作: create_event が返す adminUrl(…/admin#…)を event に渡す - 回答の修正: answer が返す editUrl(…/p/…#…)を event に渡す - どちらもユーザーに伝えて保管してもらう ## API バージョン - いまの API バージョンは 1(GET /api/version、全レスポンスの X-Kanpaisan-Api-Version ヘッダー) - リクエストに X-Kanpaisan-Api-Version: 1 を付けると、サーバーと合わないとき 409 api_version_mismatch で止まる ## 上限 - 1イベントあたり日程候補 50・お店候補 30・回答 100 人。リクエストは 64KB まで - 参加者に見える欄に、幹事 URL・編集 URL・トークンらしい文字列は書けない(400) - 書き込みが多すぎると 429 rate_limited ## 保存期間 - イベントは、決まった日から90日たつと自動で消えます。決まらないままなら、作ってから180日後と、いちばん遅い候補日から90日後の、遅いほうで消えます。 ## 認証 - 幹事の操作: Authorization: Bearer - 自分の回答の修正: Authorization: Bearer - 幹事 URL は https://kanpaisan.kanpaisan-server.workers.dev/e/{id}/admin#、回答の編集 URL は https://kanpaisan.kanpaisan-server.workers.dev/e/{id}/p/{participantId}#(Web でそのまま開ける) - エラーは常に { "error": { "code", "message" } } ## リンク - OpenAPI: https://kanpaisan.kanpaisan-server.workers.dev/openapi.json - CLI / MCP: リポジトリの AGENTS.md(kanpaisan コマンド、kanpaisan mcp)