# MCPの概要

> Specify MCPサーバーで、Claude Code・Codex・Cursorなどのコーディングエージェントにチームの文脈をつなぎます。

コーディングエージェントは有能ですが、私たちのチームのことは知りません。SpecifyはMCPサーバーとして動作し、Claude Code・Codex・Cursorなどのエージェントがチームのドキュメント・意思決定・コードの文脈を直接探索できるようにします。

## MCPとは

MCP（Model Context Protocol）は、AIエージェントを外部のツールやデータに接続するためのオープン標準です。SpecifyはMCPサーバーを提供しているため、MCPに対応したクライアントであれば、ワークスペースの権限で許可された範囲内でチームのドキュメントを検索し、読み取れます。

## できること

<CardGroup cols={3}>
  <Card icon="search" title="チームのドキュメントを検索">エージェントが作業中に必要なドキュメントをワークスペースから探して読み取ります。</Card>
  <Card icon="library" title="同じ文脈を共有">チームがSpecifyに残した文脈が、そのままエージェントが読み取る文脈になります。</Card>
  <Card icon="file" title="ドキュメントの作成">書き込み権限を許可すると、エージェントがドキュメントを作成・編集できます。</Card>
</CardGroup>

## サーバー情報

| 項目 | 値 |
| --- | --- |
| サーバーのアドレス | `https://mcp.specify.app` |
| トランスポート | Streamable HTTP（JSONレスポンス、SSEセッションなし） |
| 認証 | ワークスペースのMCPトークン（Bearer）またはOAuth |
| 権限スコープ | `mcp:read`（既定）、`mcp:write`（任意） |
| サーバー名 | すべてのクライアントで`specify`に統一 |

<Note>
  接続コマンドとトークンは、ワークスペースの画面で発行するのが最も簡単です。接続を選択すると、そのワークスペースへのアクセス権限が発行され、クライアントごとのコマンドや設定が用意されます。
</Note>

## 接続方法の概要

<Steps>
  <Step title="ワークスペースでエディタ連携を開く">
    サイドバーの一番下にあるアカウントメニューで**スキル・コネクタ**を押すと、**ツールとスキル**ウィンドウが開きます。**エディタ連携**タブで、使用するクライアントを選択します。

    <Screenshot name="tools-editor-connect" alt="ツールとスキルウィンドウのエディタ連携タブと、クライアント接続カード" />
  </Step>
  <Step title="権限スコープを決める">
    既定は読み取り専用です。エージェントがドキュメントを作成・編集する必要がある場合は、**文書の作成・編集を許可**にチェックを入れます。
  </Step>
  <Step title="コマンドまたは設定を適用する">
    クライアントに応じて、ターミナルでコマンドを実行するか、設定を貼り付けるか、ディープリンクでエディターを開きます。クライアントごとの方法は[エディター・エージェントの接続](/ja/mcp/connect)を参照してください。
  </Step>
  <Step title="文脈の上で質問する">
    意思決定・ドキュメント・コードについて質問すると、エージェントは一般的な推測ではなく、チームの実際の文脈を根拠に回答します。
  </Step>
</Steps>

## 次のステップ

<CardGroup cols={3}>
  <Card icon="terminal" title="エディター・エージェントの接続" href="/ja/mcp/connect">Claude Code、Codex、Cursor、VS Code、Claude Desktopの接続方法</Card>
  <Card icon="blocks" title="提供ツール" href="/ja/mcp/tools">search、read_document、browse、create_document、update_document</Card>
  <Card icon="key" title="トークンとアクセス方針" href="/ja/mcp/access">トークンの権限と失効、管理者向けのアクセス方針</Card>
</CardGroup>