Skip to main content

Set up Cursor for Kanera MCP

Cursor connects to Kanera through the Model Context Protocol. Cursor supports remote Streamable HTTP servers with OAuth, so you can connect through a browser without creating or storing an API key.

Add Kanera to your global Cursor MCP configuration at ~/.cursor/mcp.json, or to .cursor/mcp.json in a project when the connection should only be available there:

{
  "mcpServers": {
    "kanera": {
      "url": "https://mcp.kanera.app/mcp"
    }
  }
}

Cursor detects that Kanera requires OAuth and asks you to authenticate. In Cursor Agent, you can start the browser flow explicitly:

cursor-agent mcp login kanera

Sign in to Kanera, review the requested access, and choose Allow access. Then verify the connection and available tools:

cursor-agent mcp list
cursor-agent mcp list-tools kanera

In the Cursor editor, open Settings -> Tools & MCP to inspect the server and its tools. See Connect an AI agent for scopes and disconnecting an agent.

Install the Kanera skill​

The MCP connection gives Cursor access to Kanera's tools. The optional Kanera agent skill teaches it to resolve names to stable IDs, read live state before reporting or changing work, distinguish completed work from creation activity, use idempotency keys, and handle permission or rate-limit failures safely.

Install the skill globally with the open Agent Skills installer:

npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera --yes --global

For a manual installation, download the complete kanera skill directory and place it in one of these locations:

  • ~/.agents/skills/kanera/ or ~/.cursor/skills/kanera/ for a personal skill available across projects.
  • .agents/skills/kanera/ or .cursor/skills/kanera/ in a repository to share the skill with that project.

Restart Cursor if the skill does not appear. Cursor can load it automatically for relevant requests, or you can invoke /kanera explicitly.

Connect with an API key​

Use a static API key when OAuth is unavailable. Keep the key in an environment variable rather than committing it to a project configuration:

{
  "mcpServers": {
    "kanera": {
      "url": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:KANERA_API_KEY}"
      }
    }
  }
}

Set KANERA_API_KEY in the environment that launches Cursor. Create a personal key in Profile settings -> API keys or a workspace key in Workspace settings -> API.