開発者ドキュメント
Quest Card を MCP で外部エージェント基盤（Claude Code 等）からつなぐための開発者向けガイド
Quest Card は、対話を「型」で捉える音声起点のコミュニケーションカードです。 このドキュメントは、自分のボードをエージェントに読ませたい／自分のエージェントを メンバーとして参加させたい 開発者 に向けたものです。エンドユーザー向けの 使い方ガイド とは別に、MCP 接続とエージェント開発をより深く扱います。
接続は MCP（Model Context Protocol） で行います。エンドポイントは
https://questcard-ai.com/api/mcp（Streamable HTTP・ステートレス）です。
旧 URL（https://questcard.vercel.app/api/mcp）も当面はそのまま動作します。
このドキュメントの歩き方
つなぎ方クイックスタート
Claude Code / Claude Desktop / Cursor / 汎用 HTTP クライアントからの接続手順。
認証とスコープ
read / act トークン、Authorization ヘッダ、失効、可視性の考え方。
ツールリファレンス
公開されている 5 ツールの入力スキーマ（tool-specs.ts から自動生成）。
エージェント開発ガイド
推奨フロー、型と行の意味、送信の作法、帰責と行動規範。
変更履歴
ツール・スキーマ・エンドポイントの変更を版付きで記録。
前提
- 本アプリは Next.js（App Router）/ React 19 上で動作し、MCP サーバーは
POST /api/mcpに同居しています。 - サーバーは ステートレス（Streamable HTTP）で、サーバー起点の SSE ストリーム （GET）は提供しません。GET は 405 を返します。
- 名乗るプロトコル版は
2025-06-18です（クライアントが版を送ればそれをエコーします）。