HarborHarbor
DocumentationGuidesPlugins
Get Started

Connect Codex

Point Codex CLI at Harbor's MCP server.

Codex CLI speaks Model Context Protocol (MCP) over streamable HTTP. Pointing it at Harbor takes one config block.

You need to be logged in to Harbor first — see Sign up & install hrbr.

Open the config file

~/.codex/config.toml

If the file doesn't exist, create it.

Paste the Harbor block

[mcp_servers.harbor]
type = "url"
url = "https://mcp.tryharbor.ai/mcp"

If you already have other MCP servers configured, add the harbor entry next to them under the same mcpServers object.

Restart Codex CLI

The first time you invoke a Harbor tool from inside Codex CLI, your browser opens for OAuth 2.1 + PKCE. Consent, return to the editor, and the agent now has inspect + exec against your workspace.

Try it

Ask your agent something only Harbor can answer:

"List my five most recent Linear issues."

Codex CLI calls Harbor's inspect tool to discover the right plugin, then exec to run the search. Watch the run land in Traces.

Tool budget

Codex CLI sees only two tools from Harbor — inspect and exec. It doesn't matter how many plugins your workspace has (5 or 500), the visible tool budget stays the same. See For Agents → Connecting for the pattern.

Where to go next

Install your first plugin →

Your first exec →

Connect Cursor

Point Cursor at Harbor's MCP server.

Connect Gemini CLI

Point Gemini CLI at Harbor's MCP server.

On this page

Open the config filePaste the Harbor blockRestart Codex CLITry itTool budgetWhere to go next