Connect Kanera to your AI agent
Connect the AI tools you already use to search, plan, summarize, and update real Kanera work across every accessible board.
Plan availability: Hosted AI agent connections require a paid or trial Kanera plan. Free organisations can start a trial during setup.
Connect now
Choose the shortest path for your AI client. OAuth is recommended for a personal assistant because you do not need to create or store an API key.
Coding agents
Paste one instruction into Codex, Claude Code, Cursor, Copilot, Gemini CLI, or OpenCode.
Fetch https://www.kanera.app/agent-setup/prompt.md and follow it.Other MCP clients
Add the hosted server address. A compatible client opens Kanera sign-in and consent.
https://mcp.kanera.app/mcpThe setup prompt installs Kanera's official Agent Skill, registers the hosted MCP server, and starts OAuth where the coding agent supports it. Always review the Kanera consent screen before allowing access.
Choose your AI client
Use a client-specific guide when you want exact menu names, commands, configuration locations, and troubleshooting steps.
ClaudeSet up Claude Code or the Claude desktop app.CodexConnect the app, CLI, or IDE extension.GitHub CopilotAdd Kanera to Copilot in Visual Studio Code.What you can do
Kanera MCP works across boards, assignments, notes, comments, labels, custom fields, checklists, and activity. These workflows show where the connection is most useful.
Plan work, then track it as code lands
Read this repository and the "Upgrade dependencies" card. Write the implementation plan into the card, add one checklist item per project, and update each item after its build passes.
A coding agent can keep the shared card current while it works in the repository. Changes require Write access.
Prepare a standup from real progress
Prepare my standup for the Platform board. Separate work completed yesterday, work in progress today, and blockers.
Combine completed-work records, current assignments, and board activity instead of inferring progress from card creation dates.
Review workload across boards
Show open work per person across this workspace. Flag overdue, unassigned, and stale cards, then suggest where work could move.
Assignment and activity tools let an agent reason across a team without opening each board separately.
Turn notes into structured work
Read my onboarding note and draft cards for each action item. Show the proposed fields before creating anything.
Use a draft, review, apply pattern. Reading and drafting are read-only; creating cards requires Write access.
See more practical prompts and workflows →
Why Kanera MCP
Kanera exposes more than single-board card operations:
- Work across your accessible boards. Personal OAuth connections and personal keys follow your current board permissions across workspaces, standalone boards, and guest boards.
- Use the right identity for the job. Connect as yourself with OAuth, create a scoped unattended agent for CI or cron, or use an API key for a local or custom deployment.
- Manage complete workflows. Work with cards, lists, checklists, comments, labels, custom fields, assignments, notes, activity, completed work, and bulk card actions.
- Keep sensitive automation narrow. Workspace service connections can be capped at Read, Write, or Admin.
- Connect self-hosted Kanera. Use your deployment's MCP address instead of the hosted default.
- Give the agent product guidance. The official Agent Skill teaches safe discovery, stable ID resolution, idempotency, permission handling, and Kanera's workspace model.
Access at a glance
| Connection | Acts as | Best for |
|---|---|---|
| OAuth | You, within your current Kanera permissions | ChatGPT, Claude, Codex, Copilot, and other personal assistants that support remote MCP OAuth |
| Unattended agent | A workspace service identity capped at Read, Write, or Admin | CI, cron, and server-side automations |
| Personal API key | You, across the boards you can access | Local MCP clients and custom personal integrations |
| Workspace or board API key | The workspace or standalone board where the key was created | Shared integrations that need a fixed destination and centrally managed scope |
Start with read-only access for summaries, search, and reporting. Grant Write only when the agent should change Kanera data. Use Admin only for a workflow that genuinely needs workspace administration.
Frequently asked questions
What can an AI agent see?
A personal OAuth connection or personal API key can read content that you can access in Kanera. This may include boards in multiple workspaces, standalone boards, guest boards, and your private personal notes. Board access still follows explicit board membership.
A workspace or board connection is limited to the destination where its credential was created. An unattended agent is also limited by its configured maximum scope.
Can the agent change my work?
Only when the connection has Write access and the acting identity has permission to edit the target board. Read-only connections can inspect, search, summarize, and report without changing Kanera.
Ask the agent to show a draft or proposed plan before applying a sensitive or broad change.
What can and cannot be deleted?
Kanera MCP cannot delete boards, lists, custom fields, notes, or note attachments. Delete those manually in the Kanera interface.
It can delete comments authored by the acting user, checklists, and checklist items when you explicitly request the operation and the connection has Write access. Cards can be archived individually or in batches. See the technical reference for the complete boundary.
Can a connection access multiple workspaces?
Yes. A personal OAuth connection or personal API key follows the connected user's accessible boards across workspaces and standalone boards. A workspace key or unattended agent remains pinned to one workspace or standalone board.
How do I disconnect an agent?
Open Profile settings -> API keys, find AI agent connection, and choose Disconnect agent. Existing access and refresh tokens stop working immediately.
Delete an unattended agent from Workspace settings -> API to revoke its credentials and active tokens.
Does Kanera MCP consume AI tokens?
Yes. Kanera does not charge AI tokens, but MCP results become context in your AI client and count toward that client's message or token limits.
Does MCP work with self-hosted Kanera?
Yes. Add the MCP address shown by your Kanera deployment. For a coding agent, copy the setup prompt from Profile settings -> API keys so it uses your deployment's address instead of the hosted default.
When should I use an API key?
Use an API key for local stdio, a client that only accepts a static bearer token, or a custom deployment where OAuth is unavailable. Prefer OAuth for an interactive personal assistant and an unattended agent for CI or server-side automation.