使用说明

碳酸mcp

MCP服务器起泡的任务管理。展示了7个用于管理公告板、卡片、评论和清单的工具。

先决条件

获取您的Fizzy访问令牌：

登录到起泡的
前往“设置”>“API访问”
生成新令牌

如何安装

Claude Desktop

添加到您的配置文件中：

macOS： ~/Library/Application\ Support/Claude/claude_desktop_config.json
窗户： %APPDATA%\Claude\claude_desktop_config.json
Linux： ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      }
    }
  }
}

仅限Windows： 添加 "APPDATA": "C:\\Users\\YourUsername\\AppData\\Roaming" 到 env 块。

完全重新启动Claude Desktop，然后验证：“列出我的Fizzy板。”

Claude Code

使用CLI：

claude mcp add --transport stdio Fizzy --env FIZZY_TOKEN=your-token-here -- npx -y @silky/fizzy-mcp

或添加到 ~/.claude.json:

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      }
    }
  }
}

重新启动Claude Code，然后验证：“列出我的Fizzy板。”

Cursor

增添 ~/.cursor/mcp.json （全球）或 .cursor/mcp.json （项目）：

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      }
    }
  }
}

完全重新启动Cursor，然后在代理模式（Ctrl+I）下进行验证。

VS Code

增添 .vscode/mcp.json 在您的工作空间中：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "fizzy-token",
      "description": "Fizzy API Token",
      "password": true
    }
  ],
  "servers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "${input:fizzy-token}"
      }
    }
  }
}

或者通过命令面板使用用户设置→ “MCP：打开用户配置”。

Windsurf

增添 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "${env:FIZZY_TOKEN}"
      }
    }
  }
}

集 FIZZY_TOKEN 在您的shell环境中，或者对值进行硬编码。重新启动Windsurf。

Cline

添加到Cline MCP设置文件：

macOS： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
窗户： %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Linux： ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Continue

增添 .continue/config.yaml:

mcpServers:
  - name: Fizzy
    command: npx
    args:
      - "-y"
      - "@silky/fizzy-mcp"
    env:
      FIZZY_TOKEN: ${{ secrets.FIZZY_TOKEN }}

From Source

需要 pnpm.

git clone https://github.com/davegomez/fizzy-mcp.git
cd fizzy-mcp
pnpm install
pnpm build

替换 npx -y @silky/fizzy-mcp 随着 node /absolute/path/to/fizzy-mcp/dist/index.js 在上面的任何配置中。

配置参考

变量	必填	默认	描述
`FIZZY_TOKEN`	是	-	Fizzy设置中的API令牌
`FIZZY_ACCOUNT`	否	--	默认帐户段符（例如。， `897362094`)
`FIZZY_BASE_URL`	没有	`https://app.fizzy.do`	API基本URL

账户解析

工具解析 account_slug 按照以下顺序：

明确的 account_slug 工具调用中的参数
会话默认值（通过设置 fizzy_account 工具与 action: "set")
FIZZY_ACCOUNT 环境变量
自动检测（如果用户只有一个帐户）

工具参考

fizzy_account

获取、设置或列出后续工具调用的帐户。

参数	类型	必填	说明
`action`	`"get"`	`"set"`	`"list"`
`account_slug`	string	For `set`	来自Fizzy URL的帐户段塞

退货：

get: { "action": "get", "account_slug": "897362094" | null }
set: { "action": "set", "account_slug": "897362094" }
list: { "action": "list", "accounts": [{ "slug": "...", "name": "...", "id": "..." }] }

泡沫板

列出帐户中带有列摘要的板。

参数	类型	必填	默认	说明
`account_slug`	string	否	会话默认值	帐户段符
`limit`	number	否	25	每页显示项目数（1-100）
`cursor`	string	否	--	分页光标

退货： { "items": Board[], "pagination": { "returned": number, "has_more": boolean, "next_cursor"?: string } }

fizzy_search

搜索带有过滤器的卡片。

参数	类型	必填	说明
`account_slug`	string	否	帐户段符
`board_id`	string	否	按板筛选
`tag_ids`	string[]	否	按所有标签筛选
`assignee_ids`	string[]	否	按任何受让人筛选
`creator_ids`	string[]	否	按卡片创建者筛选
`closer_ids`	string[]	否	按关闭者筛选
`card_ids`	string[]	否	筛选到特定的卡ID
`indexed_by`	`"closed"`	`"not_now"`	`"all"`
`assignment_status`	`"unassigned"`	否	按分配状态筛选
`sorted_by`	`"newest"`	`"oldest"`	`"recently_active"`
`terms`	string[]	否	自由文本搜索词
`creation`	日期范围*	否	按创建日期筛选
`closure`	日期范围*	否	按关闭日期筛选
`limit`	number	否	每页项目数（1-100，默认值25）
`cursor`	string	否	分页光标

*日期范围值： today, yesterday, thisweek, thismonth, last7, last14, last30.

退货： { "items": Card[], "pagination": {...} }

汽泡卡

按编号或ID获取卡的完整详细信息。

参数	类型	必填	说明
`account_slug`	string	否	帐户段符
`card_number`	number	No*	来自URL的卡号（例如。， `42` 从 `#42`)
`card_id`	string	否*	API响应中的卡UUID

*提供 card_number 或 card_id.更喜欢 card_number 当你有人类可读的 # 从UI。

退货： 卡片对象 id, number, title, description （降价）， status, board_id, column_id, tags, assignees, steps_count, completed_steps_count, comments_count, url，时间戳。

fizzy_task

创建或更新卡。

模式： 省略 card_number 创造；包括它以进行更新。

参数	类型	必填	说明
`account_slug`	string	否	帐户段符
`card_number`	number	No	要更新的卡（创建时省略）
`board_id`	string	创建模式	新卡板
`title`	string	创建模式	卡片标题
`description`	string	否	Markdown内容
`status`	`"open"`	`"closed"`	`"not_now"`
`column_id`	string	否	按列分类
`position`	`"top"`	`"bottom"`	否
`add_tags`	string[]	否	标记要添加的标题
`remove_tags`	string[]	否	标记要删除的标题
`steps`	string[]	否	检查表项目（仅限创建模式）

退货： { "mode": "create" | "update", "card": {...}, "operations": {...}, "failures": [...] }

fizzy_comment

在卡片上创建、列出、更新或删除评论。

参数	类型	必填	说明
`action`	string	否	`"create"` （默认）， `"list"`, `"update"`, `"delete"`
`account_slug`	string	否	帐户段符
`card_number`	number	是	卡号
`comment_id`	string	否	注释ID。更新/删除需要此ID
`body`	string	否	标记中的注释（1-10000个字符）。创建/更新所需

退货： 注释对象 id, body （降价）， creator时间戳， url.List返回 { comments, pagination }.删除退货 { comment_id, deleted }.

嘶嘶声

在卡片上创建、完成、更新、取消完成或删除步骤。

参数	类型	必填	说明
`account_slug`	string	否	帐户段符
`card_number`	number	Yes	包含步骤的卡片
`step`	string	number	No
`content`	string	否	创建或更新的步骤文本
`completed`	boolean	否	设置完成状态
`delete`	boolean	否	删除步骤

模式检测：

step 缺席的→ CREATE（需要 content)
step 当前，没有其他参数→ 完成
step + content → 更新
step + completed: false → 不完整的
step + delete: true → 删除

退货： { "id": "...", "content": "...", "completed": true }

分页参考

列表操作返回：

{
  "items": [...],
  "pagination": {
    "returned": 25,
    "has_more": true,
    "next_cursor": "opaque-cursor-string"
  }
}

字段	类型	描述
`returned`	number	此响应中的项目
`has_more`	boolean	更多可用项目
`next_cursor`	string	传递为 `cursor` 下一页

错误参考

错误	原因
“未指定帐户。请设置FIZZY_account环境变量，使用FIZZY_account工具或传递account_slug。”	任何方法都无法解析帐户
账户..“未找到”	传递给的slug无效 `fizzy_account` set
“未找到卡号N”	卡号不存在
“未找到董事会”	无效 `board_id`

许可证

AGPL-3.0或更高版本

使用说明

碳酸mcp

先决条件

如何安装

配置参考

账户解析

工具参考

fizzy_account

泡沫板

fizzy_search

汽泡卡

fizzy_task

fizzy_comment

嘶嘶声

分页参考

错误参考

许可证

相关 MCP

GitLab项目管理服务器

Primavera P6 XER文件解析服务器

规范工作流管理工具

协议桥接服务器

React开发协议服务

智能记忆与任务管理服务器