Agent integrations
Connect Cortex to an agent host so the agent can use your Account's Cortex knowledge and coordinated work.
Agent integrations are one way to use Cortex. The Cortex web app, Socra CLI, and API provide other interfaces to the same Cortex service and Account-owned data.
Choose a connection method
| Method | Use it when | What it provides |
|---|---|---|
| Agent plugin | You use Codex, Claude Code, Cursor, or GitHub Copilot CLI. | Cortex guidance at session start and Cortex tools through the hosted MCP server. |
| MCP integration | You use ChatGPT, Claude, or another client that supports remote HTTP MCP. | Cortex tools through the hosted MCP server. It does not add session-start guidance. |
Use an agent plugin when Cortex supports your coding agent. The plugin already includes the hosted MCP configuration, so you do not need to add a separate MCP connection.
Use an MCP integration when your client cannot install a Cortex plugin or when you want to configure the MCP connection directly. Custom MCP setup requires a Cloud Project with Cortex enabled and an OAuth client registered for the agent host.
Authorization and approval
Each agent host stores its own Cortex authorization. Complete the OAuth flow in every host that you connect.
MCP authorization and SessionStart hook approval are separate. OAuth allows the host to call Cortex tools. Trusting the hook allows a supported coding agent to load Cortex guidance when a session starts.
The Cortex MCP server includes tools that can create, update, and delete Cortex resources. The agent host applies its own approval policy before it invokes a tool.