# MCP 接続

> 再利用できるツール接続を一元管理し、本当に必要な Agent にだけ有効化します。

Source: https://docs.syfo.ai/ja/docs/mcp-connections

MCP（Model Context Protocol）は、ツールを接続するための標準プロトコルです。Syfo で MCP 接続を作成すると、Linear や社内 API などの外部ツールを Agent が使えるようになります。接続は 1 回作成すれば複数の Agent に有効化でき、有効化された Agent だけがその接続を使えます。

入口：「設定 › MCP接続」。Agent 詳細ページの「MCP」タブから直接作成することもできます。

## ステップ 1：接続を作成する

1.  「設定 › MCP接続」を開き、「接続の作成」をクリックします。
2.  「名前」と「説明」（この接続を何に使うか）を入力します。
3.  「範囲」を選びます。
    -   **個人的な**：自分だけが閲覧でき、自分がオーナーの Agent にだけ有効化できます。
    -   **組織**：組織全体で閲覧でき、どの Agent にも有効化できます。作成と編集ができるのは組織のオーナーまたは管理者だけです。

    範囲は作成時に決まり、後から変更することはできません。

## ステップ 2：トランスポートを選んで設定を入力する

| トランスポート | 向いている用途 | 入力する内容 |
| --- | --- | --- |
| Streamable HTTP | リモートの MCP サービス | URL。認証が必要な場合は「トークン」を入力します。Bearer token として挿入されます |
| stdio | Agent がいるコンピューター上で起動するローカルの MCP プログラム | Command、Args（1 行に 1 つの引数）。キーは「環境変数」に入力します。プロセスの環境変数として挿入されます |

-   トークンと環境変数は、保存後は元の値が表示されず、名前だけが表示されます。
-   既存の JSON 設定がある場合は、「高度な JSON」に切り替えてそのまま貼り付けられます。
-   Agent の「MCP」タブで stdio 接続を新規作成するときは、「このコンピューターに紐づける」にチェックを入れられます。チェックを入れると、コマンドの実行とキーの配布はそのコンピューター上だけで行われます。チェックを入れない場合、この接続を有効化した Agent がいるどのコンピューターでもこのコマンドが実行され、キーが渡されます。

設定を入力したら「接続の作成」をクリックします。

## ステップ 3：テストする

接続一覧で「テスト」をクリックします。結果は次のいずれかです。

-   **到達可能**：サービスに接続できます。
-   **認証が必要です**：サービスには接続できますが、正しい認証情報が必要です。
-   **到達不能**：接続できません。URL とネットワークを確認してください。
-   **エラー応答**：サービスがエラーを返しました。

stdio 接続は Agent がいるコンピューター上で動くため、サーバー側からはテストできず、「stdio: エージェント ホストでのテスト」と表示されます。この種類の接続はそのまま次のステップに進み、有効化した後に実行状態を確認してください。

## ステップ 4：Agent に有効化する

1.  Agent 詳細ページを開き、「MCP」タブに切り替えます。
2.  「利用可能な接続」で対象の接続を見つけ、「有効にする」をクリックします。有効化・無効化ができるのは Agent のオーナーだけです。
3.  「MCP の変更が保存されました。エージェントが現在実行中の場合は、変更を有効にするためにエージェントを再起動します。」と表示されます。表示内のボタンをクリックして Agent を再起動します。

不要になったら「無効にする」をクリックします。こちらも Agent を再起動してから反映されます。

## ステップ 5：実行状態を確認する

再起動後、Agent の「MCP」タブに戻り、各接続の状態を確認します。

-   **ランタイムの健全性が確認されました**：MCP の初期化に成功しており、Agent が使用できます。
-   **ランタイムが使用できない MCP を検出しました**：原因が表示されます。たとえば、認証の失敗、サービスに接続できない、Agent がいるコンピューターに必要なコマンド・ディレクトリ・権限・環境変数がない、などです。
-   **ランタイムの健全性が検証されていません**：まだ実行結果がありません。通常は、Agent がまだ再起動されていないか、まだその接続を使っていないことが原因です。

## 「ランタイムから継承」とは

Agent の「MCP」タブの下部には、「ランタイムから継承 · 読み取り専用」というグループもあります。これは、Agent が使うランタイム（Codex、Claude Code など）がそのコンピューター上で独自に設定している MCP です。ランタイムが管理しているため、Syfo では表示のみで、有効化、無効化、編集はできません。

Syfo で作成した接続は、スキル、チャンネル、コンピューターから自動的に継承されることはありません。Agent ごとに明示的に有効化する必要があります。

## 管理、取り消し、削除

「設定 › MCP接続」で「管理する」をクリックすると、設定の変更や「この接続を使用しているエージェント」の確認ができ、個別に「バインドを解除する」か、「すべてのバインドを解除する」ことができます。

-   設定を変更した場合、実行中の Agent は再起動するまで新しい設定を使いません。
-   使用中の接続を「取り消し」すると、その接続を使っているすべての Agent は、次回の再起動後にその MCP を使えなくなります。
-   Agent が使用中の接続は削除できません。先に各 Agent で無効化してください。削除は元に戻せません。

## 認証情報と権限

-   専用で、最小権限の認証情報を使ってください。
-   キーをチャンネルや Agent のプロンプトに貼り付けないでください。長期間保存して Agent に使わせる認証情報は、[パスワード保管庫](https://docs.syfo.ai/ja/docs/vault) に保存してください。
-   顧客や環境の境界が異なる場合は、接続と認証情報を分けてください。
-   Agent やプロジェクトで不要になったら、接続を無効化し、認証情報をローテーションするか取り消してください。

## トラブルシューティング

接続のテストは成功したのに Agent が呼び出せない場合は、次の順に確認してください。

1.  その Agent の「MCP」タブで、対象の接続を「有効にする」で有効化してあるか。
2.  有効化または変更の後に Agent を再起動したか。
3.  「MCP」タブに表示される実行状態とエラーの原因。
4.  認証情報の権限範囲と、外部サービス側の権限設定。

:::note
テストに合格しても、サービスに接続できることがわかるだけで、すべての Agent が使えるわけではありません。Agent が使えるのは、その Agent に有効化された接続だけです。
:::