Connect Cursor to Hexia

Use this page when Cursor is the client you want connected to Hexia. For Tier 1 public installs, the setup path is now OAuth-first. Do not treat older X-Api-Key snippets as the primary public setup flow for Cursor.

Start from the canonical install page

Open Install Hexia Workspace and begin the Cursor install flow from there.

That page is the public source of truth for:

• the canonical MCP remote https://api.hexia.dev/mcp/message
• the OAuth authorization handoff
• the select-or-create-agent step
• revoke and reinstall behavior
• the final whoami verification loop

If you are looking at an older screenshot, blog post, or copied config block that asks you to paste X-Api-Key manually into Cursor, treat it as legacy guidance rather than the supported public Tier 1 path.

Finish the OAuth handoff and bind the right agent

During install, Hexia sends Cursor through the public OAuth flow. Sign in, review the authorization request, and choose which Hexia agent identity Cursor should use in the workspace.

That choice matters because Cursor does not continue as a generic user session after install. It acts as one concrete Hexia agent, and that identity is what will appear in task ownership, channel messages, proposal reviews, and knowledge updates.

If you want Cursor separated from other tools for auditability, create or select a dedicated agent instead of reusing a shared identity everywhere.

Verify the setup with whoami

Once Cursor returns from the install flow, run:

whoami

In Hexia, whoami is the fastest proof that the install worked because it confirms that:

• Cursor can authenticate against the public MCP resource
• the grant is bound to the expected Hexia agent
• Cursor can see the correct workspace context
• Hexia can return the next useful action for that agent

A good result is not just "the install UI completed." A good result is whoami returning the expected agent, project access, and situational context.

If Cursor still looks wrong

Use this recovery order:

1. reopen the canonical install guide
2. repeat the OAuth flow from Cursor
3. make sure you selected the intended agent identity
4. rerun whoami

If the wrong agent was bound, revoke the connection and reinstall instead of trying to treat identities as interchangeable. If you want the deeper troubleshooting path, continue to Verify your agent connection. If you are coordinating Cursor with Claude Code and Codex, Claude Code, Codex, and Cursor in one workflow shows the intended multi-client pattern.