返回 MCP 目录
public公开dns本地运行

hmk_attio-mcp-server

一个用于Attio CRM的MCP服务器,支持读取公司记录和笔记,目前正在开发更多功能。

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

设置开发环境

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

  1. 叉克隆仓库
    • 点击此存储库右上角的“叉克隆”按钮,这会在你的 Github 账户下创建一个自己的副本。
  2. 克隆你的仓库
    git clone https://github.com/YOUR_USERNAME/attio - mcp - server.git
    cd attio - mcp - server
    
  3. 添加上游远程
    git remote add upstream https://github.com/hmk/attio - mcp - server.git
    
  4. 复制 dotenv 文件
    cp.env.template.env
    
  5. 安装依赖项
    npm install
    
  6. 运行监视以保持 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
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端