MCP 接続

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

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

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

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

「設定 › MCP接続」を開き、「接続の作成」をクリックします。
「名前」と「説明」（この接続を何に使うか）を入力します。
「範囲」を選びます。
- 個人的な：自分だけが閲覧でき、自分がオーナーの 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 に有効化する

Agent 詳細ページを開き、「MCP」タブに切り替えます。
「利用可能な接続」で対象の接続を見つけ、「有効にする」をクリックします。有効化・無効化ができるのは Agent のオーナーだけです。
「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 に使わせる認証情報は、パスワード保管庫に保存してください。
顧客や環境の境界が異なる場合は、接続と認証情報を分けてください。
Agent やプロジェクトで不要になったら、接続を無効化し、認証情報をローテーションするか取り消してください。

トラブルシューティング

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

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