项目简介

Attio MCP 服务器是一个强大的后端服务，旨在将Attio CRM的功能无缝集成到AI助手中，如Claude和ChatGPT。它通过提供标准化的资源访问、工具执行和Prompt模板，让AI能够理解并操作您的Attio工作区，从而实现CRM工作流的自动化，无需手动操作或复杂的API调用。

主要功能点

完整的CRM覆盖: 支持对公司、联系人、交易、任务、列表和笔记进行搜索、创建、更新和删除等操作。
通用工具架构: 将40多个资源特定工具整合为14个通用操作，提供高效一致的CRM管理。
高级搜索与筛选: 提供强大的查询能力，支持多条件过滤、内容搜索和时间范围搜索。
批处理操作: 能够高效处理大量记录的创建、更新和删除，支持分块和错误处理。
预构建Prompt模板: 提供10个针对销售工作流优化的Prompt，例如查找联系人、记录活动、创建任务、推进交易和评估潜在客户等，帮助AI更快地完成任务。
OpenAI兼容性: 集成OpenAI Developer Mode，支持安全注解以自动批准读取操作，并请求写入操作的确认。

安装步骤

前提条件: 确保您的系统已安装Node.js (v18或更高版本)。
获取Attio API密钥和工作区ID: 访问 Attio API设置页面获取您的API Key和工作区ID。
通过NPM安装 (推荐): 打开终端并运行以下命令： 'npm install -g attio-mcp-server'

手动安装 (Git):

git clone https://github.com/kesslerio/attio-mcp-server.git
cd attio-mcp-server
npm install
npm run build

服务器配置 (供MCP客户端参考)

MCP客户端需要配置服务器的启动命令和必要的环境变量。以下是典型的配置格式和参数说明：

{
  "mcpServers": {
    "attio-mcp": {
      "command": "attio-mcp-server",
      "env": {
        "ATTIO_API_KEY": "您的Attio API Key",
        "ATTIO_WORKSPACE_ID": "您的Attio工作区ID",
        "ATTIO_DEFAULT_DEAL_STAGE": "（可选）新交易的默认阶段，例如: Interested",
        "ATTIO_DEFAULT_DEAL_OWNER": "（可选）新交易的默认所有者邮箱，例如: [email protected]",
        "ATTIO_DEFAULT_CURRENCY": "（可选）交易值的默认货币，例如: USD"
      },
      "description": "Attio CRM 智能集成服务器"
    }
  }
}

请注意: 将 '您的Attio API Key' 和 '您的Attio工作区ID' 替换为您的实际值。

基本使用方法

设置环境变量: 在运行服务器前，必须设置您的Attio API Key和工作区ID。

export ATTIO_API_KEY="your_api_key_here"
export ATTIO_WORKSPACE_ID="your_workspace_id_here"
# 可选的默认交易配置
export ATTIO_DEFAULT_DEAL_STAGE="Interested"
export ATTIO_DEFAULT_DEAL_OWNER="[email protected]"
export ATTIO_DEFAULT_CURRENCY="USD"

配置字段映射 (关键步骤): 服务器使用字段映射文件将自然语言指令转换为Attio API字段。
- 复制示例配置文件：'cp configs/runtime/mappings/sample.json configs/runtime/mappings/user.json'
- 编辑 'user.json' 文件，根据您的Attio工作区自定义字段进行配置。仅添加或覆盖默认映射，不要重复。
启动服务器: 如果您是为Claude Desktop等MCP客户端配置，通常无需手动运行启动命令，客户端会自动管理。
在AI助手中使用: 配置好MCP客户端后，您就可以通过自然语言命令与Attio进行交互。例如：
- "查找所有拥有50多名员工的AI公司，且我们在30天内未联系过它们。"
- "创建任务：明天跟进与微软的企业级交易。"
- "将John Smith从Google添加到我们的Q1潜在客户列表。"

关键词

项目简介

主要功能点

安装步骤

服务器配置 (供MCP客户端参考)

基本使用方法

信息