01
// SETUP
Generate an API key.
Go to Settings → API Keys, click Create key, and pick a scope. Read keys for safe-by-default agents, Read + Write for task agents that mutate boards.
// Remote MCP
Let AI agents run your boards.
Flux hosts a Model Context Protocol server at
/api/mcp
. Connect Claude Code, Cline, or Cursor - they'll read your boards,
move cards, leave comments, and commit work autonomously.
AI Agent Orchestration
Backlog4
Explore project & summarise
Add dark mode toggle
Use custom favicon
Add unit conversion
In Progress0
empty
Review0
empty
Agent activity
list_workspaces()
// Works with 
02
// CONFIG
Wire it into your AI client.
Add the MCP server entry to your client config. Claude Code, Cline, Cursor - all supported via plain HTTP transport.
03
// USE
Just ask in natural language.
Your agent reads boards, moves cards, posts comments, reorders columns. Every action is logged and undoable from the Flux UI.
~/.claude/claude_desktop_config.json
{
"mcpServers": {
"flux": {
"type": "http",
"url": "https://flux.umin.ai/api/mcp",
"headers": {
"Authorization": "Bearer flux_YOUR_API_KEY"
}
}
}
} READ
list_workspaces
List workspaces the user belongs to
READ
list_boards
List boards in a workspace
READ
get_board
Full board - columns + cards
READ
list_cards
All cards in a column
READ
get_card
Card detail with comments
READ
search_cards
Keyword search across all boards
WRITE
create_card
Create a card in a column
WRITE
update_card
Update title, description, due date
WRITE
move_card
Move a card across columns
WRITE
reorder_cards
Reorder cards within / across columns
WRITE
create_column
Add a new column to a board
WRITE
add_comment
Post a comment on a card
>
"List my workspaces"
>
"Show me all boards in the RedBite workspace"
>
"Create a card "Fix auth bug" in the To Do column"
>
"Move PROJ-42 to In Review"
>
"Search for cards about onboarding"
POST
/api/mcp GET
/api/mcp DELETE
/api/mcp
Auth: Authorization: Bearer flux_…
01 What is the Model Context Protocol?
+
MCP is an open standard that lets AI agents connect to external tools over a uniform interface. Flux hosts an MCP server so agents like Claude, Cline, and Cursor can read your boards, move cards, and leave comments autonomously.
02 Which AI clients work with Flux MCP?
+
Any MCP-compatible client works - Claude Code, Claude Desktop, Cline, Cursor, and any client that supports HTTP-based MCP transport. Configuration takes under a minute.
03 Do I need a separate API key for MCP?
+
No. MCP uses your standard Flux API key. Go to Settings, create a key with the scopes you need (Read for safe queries, Read + Write for task agents), and add it to your client config.
04 Is the MCP connection secure?
+
Yes. All MCP communication uses HTTPS with Bearer token authentication. API keys have granular scopes (read, write) and are workspace-scoped. Every action is logged and undoable from the Flux UI.
05 What can an AI agent do through MCP?
+
Agents can list workspaces and boards, read card details with comments and checklists, create and update cards, move cards across columns, reorder columns, post comments, and search across all boards - 12 tools in total.
// Ready to wire it up?
Mint a key. Start orchestrating.
Free with every Flux account. Read scope is safe - task agents need Write.