AI导哈

Teamleader Focus CRM协议服务

为Teamleader Focus CRM提供模型上下文协议（MCP）服务，使AI助手能够直接管理联系人、公司、交易、任务、事件和发票。

  • by artik0din
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 globodai-group/mcp-teamleader

使用说明

MCP团队领导焦点

A. 模型上下文协议（MCP） 服务器 Teamleader Focus CRM。使AI助手（Claude等）能够直接在Teamleader中管理联系人、公司、交易、任务、事件和发票。

特性

  • 📇 联系人 --列出、获取、创建、更新联系人
  • 🏢 公司 --列出、获取、创建公司
  • 💰 交易 --列出、获取、创建、更新交易/机会
  • ✅ 任务 --列出、创建任务
  • 📅 事件 --列出、获取、创建日历事件
  • 🧾 发票 --列出、获取、创建发票草稿
  • 🔐 OAuth2 --支持旋转的自动令牌刷新

先决条件

你需要一个 团队领导关注 具有API访问权限的帐户：

  1. 去 Teamleader市场 或 开发者门户
  2. 注册集成以获得您的 客户端ID 和 客户端密钥
  3. 完成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

贡献

欢迎投稿！请打开问题或提交拉取请求。

许可证

麻省理工学院 --由以下材料制成❤️ 通过 全球

相关 MCP