Attio MCP Server 使用说明

项目简介

Attio MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在连接 Attio CRM 系统与大语言模型 (LLM) 客户端，例如 Claude。它允许 LLM 通过标准化的 MCP 协议，安全地访问 Attio CRM 中的公司记录和笔记，并执行相应的操作。

主要功能点

访问公司信息: 允许 LLM 客户端检索 Attio CRM 中公司记录，获取最新的公司互动信息。
搜索公司: 支持通过公司名称关键词搜索 Attio CRM 中的公司。
读取公司笔记: 允许 LLM 客户端读取指定公司的历史笔记，了解上下文信息。
创建公司笔记: 支持 LLM 客户端在 Attio CRM 中为公司创建新的笔记，方便记录和总结信息。

安装步骤

克隆仓库

git clone https://github.com/hmk/attio-mcp-server.git
cd attio-mcp-server

复制并配置 .env 文件
```
cp .env.template .env
```
编辑 '.env' 文件，填入您的 Attio API Key。您可以在 Attio API Explorer 获取 API Key。
安装依赖
```
npm install
```

服务器配置

为了让 MCP 客户端（例如 Claude）连接到 Attio MCP Server，您需要在客户端中配置服务器信息。以下是 Claude Desktop 的配置示例，其他 MCP 客户端的配置方式类似。

{
  "mcpServers": {
    "attio": {  // 服务器名称，可以自定义
      "command": "npx",  // 启动命令，通常为 npx 或 node
      "args": ["attio-mcp-server"], // 启动命令参数，指向服务器入口文件
      "env": {
        "ATTIO_API_KEY": "YOUR_ATTIO_API_KEY" // 环境变量，用于传递 Attio API Key，请替换为您的 API Key
      }
    }
  }
}

配置说明:

'"attio"': 服务器名称，您可以自定义，用于在 MCP 客户端中标识该服务器连接。
'"command": "npx"' 和 '"args": ["attio-mcp-server"]': 指定了启动 Attio MCP Server 的命令。这里假设您已经将项目添加到了 'PATH' 环境变量中，可以直接通过 'attio-mcp-server' 命令启动。实际使用时，可能需要根据您的环境调整 'args' 中的路径，例如使用 'node path/to/your/cloned/repo/dist/index.js'。
'"env": { "ATTIO_API_KEY": "YOUR_ATTIO_API_KEY" }': 设置环境变量 'ATTIO_API_KEY'，用于服务器访问 Attio API。请务必将 '"YOUR_ATTIO_API_KEY"' 替换为您在 Attio 获取的 API Key。

基本使用方法

确保 Attio MCP Server 已成功启动。
在您的 MCP 客户端（例如 Claude）中配置并连接到 "attio" 服务器。
在 LLM 的对话中，您可以指示 LLM 使用 "attio" 服务器提供的工具来访问和操作 Attio CRM 数据。例如：
- 询问 "Search for companies named Acme Corp in Attio CRM." (Claude 可能会自动调用 'search-companies' 工具)
- 询问 "What are the latest notes for company attio://companies/COMPANY_ID?" (Claude 可能会自动调用 'read-company-notes' 工具，你需要将 'COMPANY_ID' 替换为实际的公司 ID)
- 指示 "Add a note to company attio://companies/COMPANY_ID with title 'Follow up' and content 'Schedule a follow-up meeting next week.'" (Claude 可能会自动调用 'create-company-note' 工具)

注意: 您需要参考 Attio MCP Server 提供的工具名称和参数，以便在 LLM 对话中正确指示 LLM 使用这些工具。具体的工具列表和参数可以参考代码中的 'ListToolsRequestSchema' 处理函数返回的结果。

关键词