AI Assistant Integration (MCP)

Connect AI assistants like Claude Desktop, Cursor, and Windsurf to your Corcava workspace. Your AI can read tasks, create tasks, track time, and help you work more efficiently.

What is MCP?

MCP (Model Context Protocol) is an open standard that allows AI assistants to connect to external tools and data sources. With Corcava's MCP integration, your AI assistant gains direct access to your projects, tasks, and time tracking.

Supported AI Assistants

Assistant	Type	Configuration File
Claude Desktop	General AI assistant	`claude_desktop_config.json`
Cursor	AI code editor	`~/.cursor/mcp.json`
Windsurf	AI coding assistant	Settings UI
Continue	Open-source AI assistant	`config.json`

Getting Your API Key

Before configuring your AI assistant, you need an API key:

Go to Settings → Integrations
Find the Public API section
Click Add API Key
Copy the generated key immediately (it's only shown once)
Store it securely - you'll need it for configuration

Tip: Create separate API keys for different AI assistants so you can manage access independently.

Configuration

Claude Desktop

Open Claude Desktop settings
Navigate to the MCP servers configuration
Add a new server with:

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your actual API key
Restart Claude Desktop

Cursor

Create or edit ~/.cursor/mcp.json (in your home directory)
Add the following configuration:

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your actual API key
Restart Cursor

Windsurf

Open Windsurf settings
Navigate to AI/MCP configuration
Add a new MCP server:
- Name: Corcava
- URL: https://app.corcava.com/mcp
- Authorization: Bearer YOUR_API_KEY
Save and restart Windsurf

Continue

Open Continue settings (click the gear icon in the Continue sidebar)
Edit your config.json file
Add the Corcava MCP server to the mcpServers section:

{
  "mcpServers": [
    {
      "name": "corcava",
      "transport": {
        "type": "sse",
        "url": "https://app.corcava.com/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  ]
}

Replace YOUR_API_KEY with your actual API key
Restart Continue or reload the window

What Your AI Can Do

Read Information

Your AI assistant can retrieve:

Task details - Full description, comments, dates, assignees
Board overview - Columns, task counts, project context
Project information - Client, status, related boards

Take Actions

Your AI assistant can perform:

Create tasks - Add new tasks with descriptions, dates, and assignments
Update tasks - Change status, move between columns, update details
Add comments - Document work done or leave notes
Track time - Start and stop time tracking on tasks
List and search - Find tasks, projects, and boards

Example Conversations

General Productivity (Claude Desktop)

You: "What tasks are due this week?"
AI: Lists your upcoming tasks with due dates and projects

You: "Create a task to follow up with Acme Corp about the proposal"
AI: Creates a new task and confirms the details

You: "Start tracking time on my current task"
AI: Starts the time tracker on your active task

Development Workflow (Cursor)

You: Share a Corcava task link "Help me implement this feature"
AI: Reads the task requirements and helps you write the code

You: "Add a comment to task #123 that I've completed the API changes"
AI: Adds the comment documenting your work

You: "What are the acceptance criteria for this task?"
AI: Retrieves and displays the task description and comments

Available Tools

Tool	Description
`list_tasks`	Search and filter tasks by project, board, or keyword
`get_task`	Get full details of a specific task
`create_task`	Create a new task with title, description, dates
`update_task`	Update task details or move to different column
`delete_task`	Remove a task permanently
`list_projects`	List all projects you have access to
`get_project`	Get project details and related boards
`list_boards`	List boards, optionally filtered by project
`get_board`	Get board details including columns
`list_task_comments`	Get all comments on a task
`add_task_comment`	Add a comment to a task
`start_time_tracking`	Start tracking time on a task
`stop_time_tracking`	Stop current time tracking session
`get_tracking_status`	Check if time tracking is active

Security Notes

Your API key provides full access to your Corcava data - keep it secure
Never share your API key or commit it to version control
You can deactivate or delete API keys anytime in Settings → Integrations
Each API request is scoped to your team's data only

Troubleshooting

"Authorization failed" or "Invalid API key"

Double-check you copied the full API key
Ensure the key is active in Settings → Integrations → Public API
Make sure you're using the Bearer prefix followed by a space before the key

AI doesn't see Corcava tools

Restart your AI assistant after adding the configuration
Verify the MCP server URL is correct: https://app.corcava.com/mcp
Check that the JSON configuration is valid (no syntax errors)

"Connection refused" errors

Verify your internet connection
Check if Corcava is accessible in your browser
Try regenerating your API key

Support

Need help? Contact our support team or check the Public API documentation for more details about the underlying API.