Skip to content

Codex

This connects Codex to the Halyard MCP server so the agent can search knowledge, ask experts, and capture answers. For developers wiring up a single client.

Add the Halyard server to your user-level Codex config at ~/.codex/config.toml:

~/.codex/config.toml
[mcp_servers.halyard]
enabled = true
url = "https://mcp.usehalyard.ai"

Restart Codex after editing the config. On its first call to a Halyard tool, Codex opens a browser to authorize against your Halyard account. Approve it once; the bearer token is then attached to every request.

Ask the agent to identify you and run a search:

Use Halyard to tell me who I am, then search the knowledge base for our most recent decision.

Expect a whoami call returning your user and organization, followed by a search_knowledge call. If the tools do not appear, see Troubleshooting.