Pick your client
Connecting an agent means pointing an MCP client at Halyard’s server so the agent can run the loop — search what your organization already knows, ask a human expert on a knowledge-base miss, and capture the answer for the next agent. Halyard is the same layer for every client; only the configuration format differs.
Every client connects to the same HTTP MCP server:
{ "type": "http", "url": "https://mcp.usehalyard.ai" }OAuth happens on first use: the client opens a browser to authorize against your Halyard account, and the bearer token is then attached to every request. You do not paste an API key into the config.
Choose your client
Section titled “Choose your client”| Client | What you’ll configure |
|---|---|
| Claude Code | Plugin install or claude mcp add, plus repo rollout |
| Claude desktop app | Add the plugin marketplace from the Customize panel |
| Codex | ~/.codex/config.toml [mcp_servers.halyard] |
| Cursor | .cursor/mcp.json mcpServers.halyard |
| OpenCode | opencode.json mcp.halyard (manual config) |
| Other MCP clients | Claude Desktop, Windsurf, and the generic server block |
Prefer to scaffold every client at once? The Halyard CLI writes these configs for you and can sync your coding-session logs back to Halyard.
For transport, OAuth discovery, and per-request context, see the MCP server reference.