JinDaGe - hmk_attio-mcp-server MCP Details

article

README

🚀 attio - mcp - server

这是一个专门为 Attio 的 AI 原生 CRM 服务的 MCP 服务器。它的主要价值在于允许 mcp 客户端（例如 Claude）连接到 Attio API，从而拓展了 Attio 的使用场景和功能。

🚀 快速开始

你需要准备好 ATTIO_API_KEY，这预期是一个 bearer token。你可以通过 [API Explorer](https://developers.attio.com/reference/get_v2 - objects) 右侧获取，或者配置 OAuth 并通过 Attio API 检索。

Claude Desktop 配置

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

✨ 主要特性

[x] 阅读公司记录
[x] 阅读公司笔记
[x] 写入公司笔记
[ ] 其他活动

📦 安装指南

先决条件

在开始开发之前，请确保已经安装了以下内容：

Node.js（推荐 v22 或更高版本）
npm
git
dotenv

设置开发环境

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

叉克隆仓库
- 点击此存储库右上角的“叉克隆”按钮，这会在你的 Github 账户下创建一个自己的副本。

克隆你的仓库

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

添加上游远程

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

复制 dotenv 文件
```
cp.env.template.env
```
安装依赖项
```
npm install
```
运行监视以保持 index.js 更新
```
npm run build:watch
```

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

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

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

hmk_attio-mcp-server