Cogno MCPを管理する

通常の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なしに変わることがあります。

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に次を追加します。

{
  "allowedMcpServers": [
    { "serverUrl": "https://api.example.com/mcp/work/*" }
  ]
}

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

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を追加します。

[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ではそのサーバーです。

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も公開しません。

はじめる

リリースノート

コンセプト

ガイド

リファレンス

ヘルプ

Cogno MCPを管理する

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

MCP policyでCognoを許可する

Claude Code

Codex

Cogno MCPのsecurity model

関連ドキュメント

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

​MCP policyでCognoを許可する

​Claude Code

​Codex

​Cogno MCPのsecurity model

​関連ドキュメント

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

MCP policyでCognoを許可する

Claude Code

Codex

Cogno MCPのsecurity model

関連ドキュメント