MCP团队领导焦点
 ](https://www.npmjs.com/package/globodai-mcp-teamleader) 
A. 模型上下文协议(MCP) 服务器 Teamleader Focus CRM。使AI助手(Claude等)能够直接在Teamleader中管理联系人、公司、交易、任务、事件和发票。
特性
- 📇 联系人 --列出、获取、创建、更新联系人
- 🏢 公司 --列出、获取、创建公司
- 💰 交易 --列出、获取、创建、更新交易/机会
- ✅ 任务 --列出、创建任务
- 📅 事件 --列出、获取、创建日历事件
- 🧾 发票 --列出、获取、创建发票草稿
- 🔐 OAuth2 --支持旋转的自动令牌刷新
先决条件
你需要一个 团队领导关注 具有API访问权限的帐户:
- 去 Teamleader市场 或 开发者门户
- 注册集成以获得您的 客户端ID 和 客户端密钥
- 完成OAuth2流以获得 刷新令牌
快速开始
使用npx(无需安装)
npx globodai-mcp-teamleader全局安装
npm install -g globodai-mcp-teamleader
mcp-teamleader配置
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
TEAMLEADER_CLIENT_ID | ✅ | 您的OAuth2客户端ID |
TEAMLEADER_CLIENT_SECRET | ✅ | 您的OAuth2客户端密码 |
TEAMLEADER_REFRESH_TOKEN | ✅ | 您的OAuth2刷新令牌 |
克劳德桌面
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"teamleader": {
"command": "npx",
"args": ["-y", "globodai-mcp-teamleader"],
"env": {
"TEAMLEADER_CLIENT_ID": "YOUR_CLIENT_ID",
"TEAMLEADER_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
"TEAMLEADER_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN"
}
}
}
}光标/风帆
添加到MCP设置中:
{
"mcpServers": {
"teamleader": {
"command": "npx",
"args": ["-y", "globodai-mcp-teamleader"],
"env": {
"TEAMLEADER_CLIENT_ID": "YOUR_CLIENT_ID",
"TEAMLEADER_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
"TEAMLEADER_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN"
}
}
}
}码头工人
docker run -e TEAMLEADER_CLIENT_ID=YOUR_CLIENT_ID \
-e TEAMLEADER_CLIENT_SECRET=YOUR_CLIENT_SECRET \
-e TEAMLEADER_REFRESH_TOKEN=YOUR_REFRESH_TOKEN \
ghcr.io/globodai-group/mcp-teamleader可用工具
联系人
| 工具 | 说明 |
|---|---|
teamleader_list_contacts | 列出具有筛选(术语、标签、updated_since)和分页功能的联系人 |
teamleader_get_contact | 获取特定联系人的详细信息 |
teamleader_create_contact | 创建新联系人(姓名、电子邮件、电话、标签……) |
teamleader_update_contact | 更新现有联系人 |
公司
| 工具 | 说明 |
|---|---|
teamleader_list_companies | 列出具有过滤(术语、标签、增值税号码)和分页的公司 |
teamleader_get_company | 获取特定公司的详细信息 |
teamleader_create_company | 创建新公司 |
交易
| 工具 | 说明 |
|---|---|
teamleader_list_deals | 列表处理过滤(术语、阶段、责任用户)和分页 |
teamleader_get_deal | 获取特定交易的详细信息 |
teamleader_create_deal | 与客户、阶段和估计价值达成新交易 |
teamleader_update_deal | 更新现有交易 |
任务
| 工具 | 说明 |
|---|---|
teamleader_list_tasks | 列出具有过滤和分页功能的任务 |
teamleader_create_task | 创建一个包含描述、截止日期和受让人的新任务 |
事件
| 工具 | 说明 |
|---|---|
teamleader_list_events | 使用日期范围筛选列出日历事件 |
teamleader_get_event | 获取特定事件的详细信息 |
teamleader_create_event | 创建新的日历事件 |
发票
| 工具 | 说明 |
|---|---|
teamleader_list_invoices | 列出具有过滤功能的发票(状态、日期范围、部门) |
teamleader_get_invoice | 获取特定发票的详细信息 |
teamleader_create_invoice | 使用行项目创建新的发票草稿 |
示例提示
配置后,您可以向AI助手询问以下问题:
- *“列出我标记为‘VIP’的所有联系人”*
- *通过电子邮件创建一家名为Acme Corp的新公司info@acme.example.com"*
- *“显示所有价值超过10000欧元的未结交易”*
- *“创建一个任务,在下周五之前与John Doe联系”*
- *“列出本月所有未付发票”*
- *“为X公司创建包含2行项目的发票草稿”*
API 参考
此MCP服务器包装 团队负责人聚焦API.关键细节:
- 基本URL:
https://api.focus.teamleader.eu - 身份验证: 带有自动令牌刷新功能的OAuth2
- 所有端点都使用POST JSON正文
- 分页: 用途
page.number和page.size参数
发展
# Clone
git clone https://github.com/globodai-group/mcp-teamleader.git
cd mcp-teamleader
# Install
npm install
# Dev mode
npm run dev
# Build
npm run build
# Type check
npm run typecheck贡献
欢迎投稿!请打开问题或提交拉取请求。
