Model Context ProtocolCursorClaude CodeWindsurf

AI-native task management

Connect Cursor, Claude Code, or any MCP-compatible editor to Flokzy and manage tasks without leaving your coding environment.

What you can do

✓Create tasks from a failing test or a TODO comment
✓Update task status when you open a PR
✓List your active tasks as context for the AI
✓Link a PR to an existing task
✓Add comments with investigation notes
✓Run a daily standup prompt to summarise your work

Setup

Get your API key

Open Settings → API in the Flokzy dashboard and create a new API key. Copy it — you'll need it in the next step.

Add to your editor

Cursor / Windsurf (.cursor/mcp.json)

{
  "mcpServers": {
    "flokzy": {
      "command": "npx",
      "args": ["-y", "@flokzy/mcp"],
      "env": {
        "FLOKZY_API_KEY": "fk_live_YOUR_KEY_HERE"
      }
    }
  }
}

Claude Code (~/.claude.json or project CLAUDE.md)

{
  "mcpServers": {
    "flokzy": {
      "command": "npx",
      "args": ["-y", "@flokzy/mcp"],
      "env": {
        "FLOKZY_API_KEY": "fk_live_YOUR_KEY_HERE"
      }
    }
  }
}

Replace fk_live_YOUR_KEY_HERE with your API key. The server is downloaded on first use — no global install needed.

Verify the connection

In Cursor, open the MCP panel and check that flokzy shows a green dot. In Claude Code, type:

/mcp

You should see the Flokzy tools listed (list_tasks, create_task, …).

Remote / HTTP transport

For CI environments or shared team setups, run the HTTP server instead of the stdio binary:

npx @flokzy/mcp/http
# PORT=3001  FLOKZY_BASE_URL=https://api.flokzy.com

Then point your editor at http://localhost:3001/mcp and pass X-Flokzy-Api-Key as a header.

Available tools

Tool	Description
list_tasks	List tasks with filters (assignee, status, priority, scope)
get_task	Get full task detail by ID or identifier (e.g. TEAM-42)
create_task	Create a new task with title, description, priority
update_task	Update title, description, status, priority, or assignee
add_comment	Post a comment on a task
link_pr	Link a GitHub PR URL to a task
list_projects	List all projects in the workspace

Built-in prompts

daily_standup

Fetches your active tasks and formats them into a standup update. Ask your AI: "Run the daily_standup prompt".

pr_context

Given a PR URL, looks up the linked Flokzy task and returns its description and comments as context. Useful before a code review.

Auto branch detection (optional)

Set FLOKZY_AUTO_BRANCH=true and the MCP server will read your current git branch on startup. If the branch name contains a task identifier (e.g. feat/TEAM-42-auth) it logs the task ID so the AI can pick up context automatically.

{
  "mcpServers": {
    "flokzy": {
      "command": "npx",
      "args": ["-y", "@flokzy/mcp"],
      "env": {
        "FLOKZY_API_KEY": "fk_live_YOUR_KEY_HERE",
        "FLOKZY_AUTO_BRANCH": "true"
      }
    }
  }
}

Troubleshooting

Tools not appearing in Cursor: Restart Cursor after adding the config. The MCP panel (bottom-left) shows connection errors if the API key is invalid.
npx hangs on first run: The package is downloading. Wait ~30 s. Subsequent runs are instant. Pre-install with npm i -g @flokzy/mcp to avoid the wait.
401 Unauthorized errors: Check that the API key starts with fk_live_ and that you haven't accidentally included quotes or extra whitespace.

Get API key →Source on GitHub →MCP specification →

Setup

Get your API key

Open Settings → API in the Flokzy dashboard and create a new API key. Copy it — you'll need it in the next step.

Add to your editor

Cursor / Windsurf (.cursor/mcp.json)

{
  "mcpServers": {
    "flokzy": {
      "command": "npx",
      "args": ["-y", "@flokzy/mcp"],
      "env": {
        "FLOKZY_API_KEY": "fk_live_YOUR_KEY_HERE"
      }
    }
  }
}

Claude Code (~/.claude.json or project CLAUDE.md)

{
  "mcpServers": {
    "flokzy": {
      "command": "npx",
      "args": ["-y", "@flokzy/mcp"],
      "env": {
        "FLOKZY_API_KEY": "fk_live_YOUR_KEY_HERE"
      }
    }
  }
}

Replace fk_live_YOUR_KEY_HERE with your API key. The server is downloaded on first use — no global install needed.

Verify the connection

In Cursor, open the MCP panel and check that flokzy shows a green dot. In Claude Code, type:

/mcp

You should see the Flokzy tools listed (list_tasks, create_task, …).

Available tools

Tool	Description
list_tasks	List tasks with filters (assignee, status, priority, scope)
get_task	Get full task detail by ID or identifier (e.g. TEAM-42)
create_task	Create a new task with title, description, priority
update_task	Update title, description, status, priority, or assignee
add_comment	Post a comment on a task
link_pr	Link a GitHub PR URL to a task
list_projects	List all projects in the workspace

Auto branch detection (optional)

{ "mcpServers": { "flokzy": { "command": "npx", "args": ["-y", "@flokzy/mcp"], "env": { "FLOKZY_API_KEY": "fk_live_YOUR_KEY_HERE", "FLOKZY_AUTO_BRANCH": "true" } } } }

Troubleshooting

Tools not appearing in Cursor

Restart Cursor after adding the config. The MCP panel (bottom-left) shows connection errors if the API key is invalid.

npx hangs on first run

The package is downloading. Wait ~30 s. Subsequent runs are instant. Pre-install with npm i -g @flokzy/mcp to avoid the wait.

401 Unauthorized errors

Check that the API key starts with fk_live_ and that you haven't accidentally included quotes or extra whitespace.