Back to MCP directory
publicPublicdnsLocal runtime

attio-mcp-server

Attio的MCP服务器,用于连接AI客户(如Claude)与Attio API,支持读写公司记录和笔记。

article

README

🚀 attio-mcp-server

这是为 Attio 提供的 MCP 服务器,它允许 MCP 客户端(如Claude)连接到 Attio API,为用户与 Attio 系统的数据交互提供了便利。

🚀 快速开始

你需要获取 ATTIO_API_KEY,这是一个 bearer token,你可以通过 API Explorer 右侧获取,或通过 Attio API 配置 OAuth 并检索。

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. 运行 watch 以保持 index.js 更新
    npm run build:watch
    
  7. 启动模型上下文协议开发服务器
    dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
    
  8. 环境变量设置提示

    ⚠️ 重要提示

    如果开发服务器未能正确加载环境变量,请在 mcp 检查器的左侧设置 ATTIO_API_KEY

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client