What is the MCP Server?
Klaro Cards exposes its API through the Model Context Protocol (MCP) — an open standard that lets AI agents interact with external tools. The MCP server is called Sia and is available at https://ai.klaro.cards/mcp.
Available Tools
Once connected, your agent has access to these tools:
Cards
| Tool | What it does |
|---|---|
| search-cards | Search for cards using keywords and dimension filters |
| create-card | Create a new card (optionally on a specific board) |
| update-card | Update a card's title, description, or dimensions |
| link-cards | Create parent/child relationships between cards |
| add-card-attachment | Upload and attach a file to a card |
Dimensions
| Tool | What it does |
|---|---|
| get-klaro-dimensions | List all dimensions and their values |
| get-klaro-dimension | Get details of a specific dimension |
| create-dimension | Create a new dimension |
| create-dimension-value | Add a value to a dimension |
Project & Navigation
| Tool | What it does |
|---|---|
| get-my-projects | List your accessible projects |
| get-project-information | Get project details |
| get-my-boards | List boards in a project |
| get-board-stories | Get all cards on a board |
| get-card | Get full details of a card |
| get-my-pinned-cards | Get your pinned cards |
| get-my-user-profile | Get your user profile |
| get-dimensions-installers | List available dimension templates |
Getting a Token
To authenticate, you need a Klaro API token:
- Log into Klaro Cards in your browser
- Open Developer Tools (F12) → Network tab
- Make any action in Klaro Cards
- Find an API request and copy the
Authorizationheader value (the part after "Bearer ")
This token gives the agent the same permissions as your user account — see Using Klaro Cards with AI Agents for best practices on creating a dedicated agent user.
Setup with Claude Desktop
- Open Claude Desktop → Settings → MCP Servers
- Add a new server:
- Name: Klaro Cards
- Transport type: Streamable HTTP
- URL:
https://ai.klaro.cards/mcp - Authentication: Bearer token
- Token: Your Klaro API token
- Click Connect
You should see the Klaro tools listed in Claude's tool panel.
Setup with Other Agents
The setup is similar for any MCP-compatible agent (VS Code Copilot, Cursor, Windsurf, etc.):
- Find the MCP server configuration in your agent's settings
- Add a new server:
- Transport: Streamable HTTP
- URL:
https://ai.klaro.cards/mcp - Authorization header:
Bearer YOUR_TOKEN
- Save and verify the connection
Troubleshooting
| Issue | Solution |
|---|---|
| "Unauthorized" error | Your token may have expired. Get a fresh one from the browser. |
| "Project not found" | Check the project subdomain. Ask the agent to list your projects first. |
| "Permission denied" | Your user may not have write access. Check workspace roles. |
| Agent can't find tools | Verify the URL is https://ai.klaro.cards/mcp and transport is Streamable HTTP. |