> ## Documentation Index
> Fetch the complete documentation index at: https://cogno.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cogno MCPを管理する

> Engine上のClaude Code・CodexのrunについてCogno MCP serverを組織のMCP policyで許可します。

通常のCogno利用ではMCP設定は必要ありません。EngineがClaude CodeとCodexのrunを自動設定します。このページは、組織がコーディングエージェントのMCP serverを制限している場合に管理者が使用します。

利用者によるMCP serverのinstall、MCP設定の編集、Cogno API keyの入力、MCP commandの手動実行は不要です。

## Cogno MCPがrunへ接続される仕組み

コーディングエージェントは、Cogno APIが`/mcp/work/`で提供するCogno MCPを通じてCognoのtask toolsへ到達します。EngineはすべてのrunへHTTPで接続します。

* **Claude Code**は、Cogno serverごとに1つのHTTP entryを持つrun単位のinline `--mcp-config`を受け取ります。
* **Codex**は、同じserverをrunの設定内の`mcp_servers` entryとして受け取ります。

各entryには、Cogno MCPのURLと、そのturnにscopeされた`Authorization: Bearer` tokenが含まれます。マシンのMCP設定fileには何も書かれず、localのMCP processも起動せず、マシンはMCP endpointも受信portも公開しません。

Cognoはtoolsを複数のMCP serverに分け、エージェントにはproviderごとにまとまって見えます。server名は`cogno`（delivery server。常に存在）と、`cogno_Slack`のようなprovider単位の`cogno_<Name>`です。tool名は`mcp__<server>__<tool>`で、例えば`mcp__cogno_Slack__slack_send_message`です。各serverは同じURLの下の専用path（例: `/mcp/work/slack/`）で提供されます。分割はCognoのサーバー側で決まるため、`cogno_<Name>`の構成はEngineのreleaseなしに変わることがあります。

```mermaid theme={"system"}
flowchart LR
    A[Claude CodeまたはCodex]
    A -->|HTTPS, turn単位のtoken| M[Cogno API /mcp/work/]
    M --> C[Cogno tools]
```

## MCP policyでCognoを許可する

MCP serverを制限していない場合は何もする必要はありません。制限している場合は、CognoのHTTP serverを許可する必要があります。以下の`api.example.com`はCogno APIのhostに置き換えてください。

| server名 | 提供先 |
| - | - |
| `cogno` | `https://api.example.com/mcp/work/core/`（または`/mcp/work/`そのもの） |
| `cogno_Slack` | `https://api.example.com/mcp/work/slack/` |
| `cogno_Teams` | `https://api.example.com/mcp/work/teams/` |
| `cogno_Discord` | `https://api.example.com/mcp/work/discord/` |
| `cogno_GoogleChat` | `https://api.example.com/mcp/work/google_chat/` |
| `cogno_Jira` | `https://api.example.com/mcp/work/jira/` |
| `cogno_Notion` | `https://api.example.com/mcp/work/notion/` |
| `cogno_Linear` | `https://api.example.com/mcp/work/linear/` |
| `cogno_GitHub` | `https://api.example.com/mcp/work/github_app/` |

runが登録するのはそのrunがtoolを使うserverだけで、一覧はサーバー側で変わり得ます。そのため、server単位ではなく`/mcp/work/`配下全体を許可してください。

### Claude Code

Claude Codeは、Cognoが`--mcp-config`で渡すserverを`allowedMcpServers`と`deniedMcpServers`に照らして判定します。remote serverのallowlist entryはURLで一致させる必要があります。allowlistに`serverUrl` entryが1つでもあると、`serverName`の一致ではremote serverは許可されません。server-managed settingsや`managed-settings.json`などのmanaged settings sourceで、`allowedMcpServers`に次を追加します。

```json theme={"system"}
{
  "allowedMcpServers": [
    { "serverUrl": "https://api.example.com/mcp/work/*" }
  ]
}
```

URL patternでは`*` wildcardを任意の位置で使えます。`deniedMcpServers`に一致すると常に拒否されるため、denylistがこれらのURLに一致しないことも確認してください。`allowedMcpServers`が未設定なら、Claude Codeはすべてのserverを許可します。

> [!WARNING]
>
> CognoがClaude Codeを動かすマシンに`managed-mcp.json`を配置しないでください。
> このfileがあるとClaude CodeはMCP serverを排他的に管理し、`--mcp-config`でserverを
> 渡されると「You cannot dynamically configure MCP servers when an enterprise MCP
> config is present」で起動時に終了します。Cognoはこの`--mcp-config`でserverを渡します。
> local commandだけでserverを固定するpolicyもCognoには一致しません。CognoのserverはHTTPで、commandを持たないためです。

### Codex

組織が`requirements.toml`で`mcp_servers`を定義している場合、Codexはstreamable HTTP serverをnameと`url` identityで照合します。Cognoの各server名に、完全一致のURLでentryを追加します。

```toml theme={"system"}
[mcp_servers.cogno]
identity = { url = "https://api.example.com/mcp/work/core/" }

[mcp_servers.cogno_Slack]
identity = { url = "https://api.example.com/mcp/work/slack/" }
```

上の表のうち、ワークスペースで使う`cogno_<Name>`ごとに同様に追加します。`mcp_servers` tableを空にするとすべてのMCP serverが無効になるため、既存tableへCognoをmergeしてください。system fileはUnixで`/etc/codex/requirements.toml`、Windowsで`%ProgramData%\OpenAI\Codex\requirements.toml`です。policyはコーディングエージェントが動くマシンに適用します。Remote Serverではそのサーバーです。

> [!WARNING]
>
> `COGNO_API_KEY`、コーディングエージェントのtoken、SSH keyをmanaged settingsやpolicy fileに書かないでください。

## Cogno MCPのsecurity model

Engineはコーディングエージェントへ、Cogno serverごとのinline設定 — cloud MCPのURLと、そのturnにscopeされたbearer token — を渡します。tokenにワークスペースのAPI keyは含まれません。すべてのrequestはCogno APIで認可され、マシンはMCP endpointも受信portも公開しません。

## 関連ドキュメント

* [Enterprise向けリモート実行運用](/docs/ja/enterprise-remote-execution.md)
* [リモートサーバーへ接続する](/docs/ja/remote-servers.md)
* [Claude Code managed MCP](https://code.claude.com/docs/en/managed-mcp)
* [Claude Code server-managed settings](https://code.claude.com/docs/en/server-managed-settings)
* [Codex managed configuration](https://learn.chatgpt.com/docs/enterprise/managed-configuration)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.