本文へスキップ
SpecifyDocs

Specify MCP

エディター・エージェントの接続

Claude Code、Codex、Cursor、VS Code、Claude DesktopにSpecify MCPサーバーを登録する方法です。

ワークスペースのツールとスキル → エディタ連携でクライアントを選択すると、そのワークスペース用のトークンが発行され、クライアントごとのコマンドや設定がトークンを入力済みの状態で用意されます。このページでは、それぞれの形式について説明します。

接続する前に権限を決める

クライアントカードの連携を押す前に、新しい接続の権限を確認してください。既定値は読み取り専用で、ドキュメントの検索と読み取りだけを許可します。エージェントがドキュメントを作成・編集する必要がある場合は、文書の作成・編集を許可にチェックを入れてから接続します。この設定は、以降に新しく発行する接続に適用されます。

以下の例の<SPECIFY_MCP_TOKEN>は、発行されたトークンに置き換えてください。

クライアントごとの接続

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

claude mcp add specify --transport http https://mcp.specify.app \
  --header "Authorization: Bearer <SPECIFY_MCP_TOKEN>"

登録後、Claude Codeからワークスペースのドキュメントを検索して読み取れるようになります。claude mcp listで登録状態を確認できます。

OAuthで接続する

Specify MCPサーバーは、OAuth認可コードフロー(PKCE S256、動的クライアント登録)にも対応しています。OAuthに対応したクライアントは、トークンなしでサーバーのアドレスだけを登録し、ブラウザでSpecifyにログインしてワークスペースと権限スコープを承認することで接続できます。スコープを指定しない場合は、読み取り専用で承認されます。

接続を確認する

  • エージェントに「Specifyでオンボーディングドキュメントを探して」のように依頼し、検索ツールが呼び出されるかを確認します。
  • エディタ連携タブのエディターのアクセス権限一覧で、発行された権限と最終使用の履歴を確認できます。この一覧は、実際のエディターの接続状態と異なる場合があります。

トラブルシューティング

症状確認すること
認証エラートークンが失効していないか、Bearer プレフィックスが含まれているかを確認します。
ツールの呼び出しが拒否されるワークスペースの外部エディターアクセスと、そのツールの許可状況を管理者に確認してください。トークンとアクセス方針を参照してください。
ドキュメントの作成・編集ができないトークンの書き込みスコープ(mcp:write)と、編集者以上の役割を確認してください。
MCPサーバーのURLが設定されていないと表示されるワークスペースの管理者にお問い合わせください。