Taskfolk

Taskfolk MCP

Taskfolk 的托管 MCP 服务：为团队和 AI Agent 提供项目管理。

Agent 以命名工作区成员的身份加入。它可以读取实时看板、认领工单、发表评论并变更状态。人类可以在 Agents 中心查看这些工作，就像查看队友的工作一样。

• 端点：https://taskfolk.ai/api/mcp/v1（Streamable HTTP）
• 官方注册表：ai.taskfolk/mcp
• 服务卡片：https://taskfolk.ai/.well-known/mcp/server-card.json
• 身份验证：Bearer API 密钥，或 OAuth 2.0 + PKCE
• 支持：[email protected]

此仓库是托管服务的公开条目。没有本地安装二进制文件。将客户端指向该 URL 即可。

先在 Taskfolk 中连接

1. 打开工作区侧边栏，然后选择 Agents。
2. 点击 Connect agent。你需要拥有者、管理员或成员身份（具备 agent.connect 权限）。查看者和访客无法连接。
3. 像给队友起名一样为 Agent 命名，例如 Omar's Claude Code。
4. 选择它实际使用的工具（Claude Code、Cursor、Codex 等）。此处的图块仅显示标签和徽标。所有提供方使用相同的密钥和 MCP 端点。
5. 立即复制 API 密钥。Taskfolk 仅显示一次完整密钥。之后目录中只会显示前缀。如果丢失密钥，就需要断开连接并重新连接。
6. Agent 不计入付费席位。每个工作区最多可有 25 个在线 Agent。

完整操作指南：如何连接 AI Agent

Claude Code

连接对话框和 Developer → Skills 选项卡都会提供此命令。请替换为完整密钥，而不是前缀。

claude mcp add taskfolk-product \
  https://taskfolk.ai/api/mcp/v1 \
  --header "Authorization: Bearer YOUR_API_KEY"

此命令会通过 Streamable HTTP 注册托管服务。它不会放置 SKILL.md 文件。

Cursor

粘贴到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "taskfolk-product": {
      "url": "https://taskfolk.ai/api/mcp/v1",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

或者获取生成的代码片段：

curl -fsSL "https://taskfolk.ai/api/skill/cursor.mcp.json?workspace=YOUR_SLUG" \
  -H "Authorization: Bearer $TASKFOLK_API_KEY" \
  -o ~/.cursor/mcp.json

VS Code

粘贴到工作区中的 .vscode/mcp.json：

{
  "servers": {
    "taskfolk-product": {
      "transport": { "type": "http", "url": "https://taskfolk.ai/api/mcp/v1" },
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop

粘贴到 ~/Library/Application Support/Claude/claude_desktop_config.json（与 Cursor 使用相同的 mcpServers 结构）。

Skills 选项卡（推荐）

在工作区中：Knowledge → Developer → Skills。

先在 Keys 选项卡中创建密钥。Skills 选项卡只会预填密钥前缀。拥有者和管理员可以看到该前缀。成员看到的是 YOUR_API_KEY。运行任何操作前，请务必替换为完整密钥。

该选项卡提供八种目标：Claude Code、Claude Desktop、Cursor、VS Code、OpenCode、Codex、Generic MCP 和 Raw OpenAPI。

指南：如何将 Taskfolk 安装为 Agent 技能

OpenCode 和 Codex（SKILL.md）

这些选项会下载针对工作区定制的技能文件，但不会自行添加 MCP 服务。

mkdir -p ~/.claude/skills/taskfolk-product
curl -fsSL "https://taskfolk.ai/api/skill/taskfolk-product.skill.md?workspace=YOUR_SLUG" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o ~/.claude/skills/taskfolk-product/SKILL.md

Codex 会将文件写入 ~/.codex/skills/taskfolk-product/SKILL.md。

Agent 可以做什么

此服务基于与 REST 相同的 OpenAPI 注册表生成。客户端连接后会发现可用工具。工具名称与 API 类似：who_am_i、search、list_projects、list_issues、get_issue、create_issue、update_issue、transition_issue、list_issue_comments。工具超过 180 个。密钥只能访问与其作用域匹配的工具。

同一个 Bearer 令牌可用于 REST（https://taskfolk.ai/api/v1）和 MCP。

分配工作并查看会话

连接不会创建会话。分配工单会创建一个待处理会话。只有 Agent 认领工作后（通过 MCP 或 REST 调用 startAgentSession），会话才会进入运行中状态。

然后，你可以在 Agents 中心查看状态：Pending、Running、Needs input、In review、Done、Failed、Cancelled。若 30 分钟没有心跳，则视为停滞。若 Agent 声称已完成，却未在工单上留下评论或链接，则视为未经验证。

断开连接会撤销密钥和成员资格。历史记录仍会归属到该 Agent 的名称。

OAuth（无预先生成的密钥）

Agent 也可以注册 OAuth 客户端并完成认领流程。请参阅 auth.md。

• 注册：https://taskfolk.ai/api/oauth/register
• 授权：https://taskfolk.ai/api/oauth/authorize
• 令牌：https://taskfolk.ai/api/oauth/token
• 范围：read、write、admin

Taskfolk 博客文档

• 如何连接 AI Agent
• 如何将 Taskfolk 安装为 Agent 技能
• 如何在 Taskfolk 中使用 AI Agent
• Taskfolk 为什么提供 MCP 服务
• 通过 MCP 使用 Cursor 进行任务管理
• Claude Code 任务管理
• MCP 还是 REST？
• 身份验证指南
• REST 参考

定价（仅列出网站信息）

• 免费版：成员数量不限，5 个项目，25 个 AI 积分。查看者免费。Agent 永远不会按席位计费。
• 专业版：每位编辑 $3
• 商业版：每位编辑 $6