Weft

Weft MCP 服务

一个看板，适用于你使用的所有 AI：Agent 认领任务并完成工作，提交证明供你验收或退回。

Weft 是一款任务看板，面向使用 AI 的个人创始人和小型团队。只需一个托管的 MCP 服务，VS Code、Claude、ChatGPT、Cursor、Copilot CLI、JetBrains、 Kiro、Codex、Gemini CLI、Warp、goose、Raycast、Perplexity、Grok、Le Chat 等十多个工具 都能使用同一个看板——无需额外插件。其中 33 个工具提供了可直接复制粘贴的设置指南。

让它成为 Agent 看板，而非带 API 的待办事项列表的关键在于：Agent 使用租约认领任务， 汇报进度以保持认领，并在完成后提交回执——其中列出可供你检查的成果，以及它未完成的工作。 你可以在网页版或手机上的收件箱中验收或退回。当需要你亲自做出决定时，问题会留给你， 而不是由 Agent 猜测答案。

服务

端点	https://letsweft.com/api/mcp
传输方式	Streamable HTTP — MCP 2026-07-28，以及面向旧版客户端的 2025 修订版
身份验证	OAuth 2.1 — Authorization Code + PKCE、动态客户端注册（RFC 7591）：首次使用时会打开浏览器窗口，让你登录 Weft 账户。对于不支持 OAuth 的客户端（脚本、CI、某些 CLI），可从 Settings → Access tokens 获取个人访问令牌，并通过 Authorization: Bearer wft_… 发送——参见访问令牌。
清单	/.well-known/mcp.json
注册表	已作为 com.letsweft/weft 发布到官方 MCP Registry（已验证域名的命名空间）

注册免费账户只需一分钟：letsweft.com/sign-up ——免费套餐每月包含 50 个活跃任务和 200 次工具调用。

安装

要在 Agent（Cline、Cursor、命令行）中进行设置？将其指向 llms-install.md——步骤相同，只是改为面向机器编写。

VS Code — 安装 Weft 扩展 （也可在 Open VSX 上获取，Cursor、Windsurf 和 VSCodium 都会从这里查找），服务器便会自动注册。若没有安装扩展，可将配置添加到 .vscode/mcp.json，或者运行 “MCP: Open User Configuration”，使其在每个工作区中都可用：

{ "servers": { "weft": { "type": "http", "url": "https://letsweft.com/api/mcp" } } }

将 Chat 切换到 Agent 模式并请求显示看板；首次使用时，VS Code 会打开浏览器进行 OAuth 授权。

GitHub Copilot CLI — 运行 copilot，输入 /mcp add，选择 HTTP，粘贴端点，保持 headers 为空，并将工具设置为 *。

Claude Code

claude mcp add --transport http weft https://letsweft.com/api/mcp

Cursor — 添加到 Cursor，或添加到 ~/.cursor/mcp.json：

{ "mcpServers": { "weft": { "url": "https://letsweft.com/api/mcp" } } }

Replit — 添加到 Replit，或依次选择 Integrations → “MCP Servers for Replit Agent” → “Add MCP server”。

ChatGPT — 已发布的插件：Plugins → 搜索 “Weft” → Connect。

Codex CLI

codex mcp add weft --url https://letsweft.com/api/mcp

Gemini CLI — 官方扩展：

gemini extensions install https://github.com/AndreiFinogeev/weft-gemini-extension

JetBrains（通过 Junie）/ Kiro / Warp / goose / Raycast / Perplexity / Grok / Le Chat / Claude Desktop / Lovable / Windsurf / Cline / Zed / 其他任何客户端 — 将 https://letsweft.com/api/mcp 添加为远程 MCP 服务（自定义连接器），并完成 OAuth 授权。各客户端的操作指南：letsweft.com/integrations。

工具（32）

类别	工具
搜索	search、fetch
看板	initialize_board、get_board_state、list_columns
任务	list_tasks、create_task、bulk_create_tasks、update_task、move_task、trash_task、restore_task、archive_done_tasks
执行工作	get_my_work、start_task、report_progress、complete_task
向人类提问	request_input、submit_answer
决策记忆	record_decision、get_context、get_task_history
项目	list_projects、create_project、update_project
冲刺	list_sprints、get_active_sprint、create_sprint、start_sprint、complete_sprint、add_task_to_sprint、remove_task_from_sprint

执行工作中的四个工具，让它成为面向 Agent 的看板，而不只是带 API 的待办事项列表。start_task 会认领任务并设置租约，返回 runId 和 leaseToken；report_progress 会续租，因为中途停止运行的 Agent 无法报告任何内容，而沉默是看板唯一能收到的信号。complete_task 接收结构化回执——可供人检查的产物、声明，以及明确未完成的事项——如果任务包含可由机器检查的验证条件，服务器会自行重新运行这些检查，然后才将卡片移至“已完成”。

request_input 则是另一半：只有人能回答的问题会在提出问题的会话结束后继续保留，在对方的收件箱（网页或手机）中等待，并返回给提出问题的客户端。

具有破坏性的工具带有 MCP 安全注解；删除操作是安全的——trash_task 会将任务保留 30 天，以便恢复。完整参考：letsweft.com/docs/mcp-tools。

可以提出的请求

• “添加一个高优先级任务：修复不稳定的 CI 测试。”
• “我现在在做什么？”
• “将身份验证重构移至‘已完成’。”
• “启动一个为期一周、聚焦于首页改版的冲刺。”
• “将我的看板整理为多个项目。”

隐私与安全

你的看板是私有的：每个会话都通过 OAuth 绑定到你的账户， 令牌按客户端单独发放。AI 创建的任务会注明创建者， 因此看板始终会显示添加每张卡片的是谁（或什么）。

支持

• 文档：letsweft.com/docs
• 电子邮件：[email protected]
• 隐私：letsweft.com/privacy