使用说明
回形针mcp
完全控制您的 回形针 通过MCP的AI仪表板——可用于Claude Code、Cowork和任何兼容MCP的客户端。
20工具 覆盖回形针仪表板的每个标签:
- 📊 仪表板概述
- 🤖 代理管理(列表、雇佣、唤醒、监控)
- 📋 发出CRUD(创建、更新、取消、过滤)
- 🏃 运行历史记录+实时成绩单查看器
- 🎯 目标和项目
- 💰 预算跟踪
- ✅ 审批队列
- 🔧 任何其他内容的原始API传递
快速开始
git clone https://github.com/creativerrr/paperclip-mcp
cd paperclip-mcp
npm install
cp .env.example .env
# edit .env with your PAPERCLIP_COMPANY_ID
node index.js # test it works
配置
将这些设置在您的 .env 文件或传递为环境变量:
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
PAPERCLIP_COMPANY_ID |
✅ | — | 您的公司UUID(来自仪表板URL) |
PAPERCLIP_API_URL |
— | http://127.0.0.1:3100 |
回形针服务器URL |
PAPERCLIP_API_KEY |
- | - | API密钥(本地/受信任实例不需要) |
PAPERCLIP_COMPANY_SLUG |
-- | -- | UI链接的公司符号(例如。 BOLA) |
查找您的公司ID: 打开Paperclip仪表板,UUID在URL或设置中。
在Claude代码中安装
添加到您的 ~/.claude/claude_code_config.json:
{
"mcpServers": {
"paperclip": {
"command": "node",
"args": ["/Users/you/paperclip-mcp/index.js"],
"env": {
"PAPERCLIP_API_URL": "http://127.0.0.1:3100",
"PAPERCLIP_COMPANY_ID": "your-company-uuid-here",
"PAPERCLIP_COMPANY_SLUG": "BOLA"
}
}
}
}
或者运行安装脚本:
./install.sh
在协作中安装
复制 SKILL.md 转到您的“共同工作技能”文件夹:
cp SKILL.md ~/.claude/skills/paperclip/SKILL.md
克劳德现在将在您询问回形针时自动使用此技能。
工具
| 工具 | 说明 |
|---|---|
dashboard |
完整的公司概述 |
list_agents |
所有具有ID和角色的代理 |
get_agent |
按slug或UUID列出的代理详细信息 |
agent_status |
一个代理的实时快照 |
wake_agent |
立即运行触发器代理 |
list_runs |
运行历史(公司或代理商) |
get_run |
完整运行记录 |
list_live_runs |
当前正在执行运行 |
list_issues |
过滤器问题 |
get_issue |
按UUID或BOLA-5样式ID发布 |
create_issue |
创建并可选择分配问题 |
update_issue |
更新任何问题字段 |
cancel_issue |
取消问题 |
list_goals |
公司目标 |
create_goal |
添加新目标 |
list_projects |
所有项目 |
hire_agent |
创建新代理 |
get_budgets |
预算/支出概览 |
list_approvals |
待批准 |
health |
服务器健康检查 |
api_call |
对任何端点的原始HTTP调用 |
示例提示(安装后)
Show me the dashboard
What issues are in progress?
Wake up Sheldon CEO
Create an issue: "Write blog post" assigned to Resi Researcher, high priority
What did Sheldon do in his last run?
List all running agents
Hire a new agent called "Video Editor" with role editor
需求
- Node.js 18+
- 回形针在本地运行(默认值:
http://127.0.0.1:3100)
许可证
麻省理工学院