attio-mcp-server

这是一个用于 Attio (AI 原生 CRM) 的 MCP 服务器。它允许 mcp 客户端（如 Claude）连接到 Attio API。

当前功能

• [x] 读取公司记录
• [x] 读取公司笔记
• [x] 编写公司笔记
• [ ] 其他活动

用法

您将需要：

• ATTIO_API_KEY

这应该是一个 bearer token，这意味着您可以通过 API Explorer 在右侧获取一个，或者配置 OAuth 并通过 Attio API 检索一个。

Claude 桌面配置

{
  "mcpServers": {
    "attio": {
      "command": "npx",
      "args": ["attio-mcp-server"],
      "env": {
        "ATTIO_API_KEY": "YOUR_ATTIO_API_KEY"
      }
    }
  }
}

开发

前提条件

在开始之前，请确保您已安装以下各项：

• Node.js (推荐 v22 或更高版本)
• npm
• git
• dotenv

设置开发环境

要设置开发环境，请按照以下步骤操作：

1. Fork 仓库

   • 单击此仓库右上角的“Fork”按钮
   • 这将在您的 Github 帐户下创建您自己的仓库副本

2. 克隆您的 Fork：

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

3. 添加上游 Remote

   git remote add upstream https://github.com/hmk/attio-mcp-server.git
   

4. 复制 dotenv 文件

   cp .env.template .env
   

5. 安装依赖项：

   npm install
   

6. 运行 watch 以保持 index.js 更新：

   npm run build:watch
   

7. 启动模型上下文协议开发服务器：

   dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
   

8. 如果开发服务器未正确加载环境变量，请在 mcp inspector 的左侧设置 ATTIO_API_KEY。