Grinfi MCP Server

Grinfi MCP服务器

连接 克劳德 致你的 Grinfi.io 账户通过自然语言管理联系人、自动化、消息等。

______________________________________________________________________

快速开始

1.获取API密钥

首选 Grinfi→ 设置→ API密钥 并复制您的密钥。

2.下载此存储库

点击绿色 “代码” 上方按钮→ “下载ZIP”，然后解压缩。

或者用Git克隆：

git clone https://github.com/alex-rise/grinfi-mcp-server.git

3.运行操作系统的安装程序

______________________________________________________________________

macOS安装

选项A：使用安装程序（推荐）

1. 打开 grinfi mcp服务器 Finder中的文件夹
2. 双击 install.sh
3. 出现提示时，粘贴您的 Grinfi API密钥 然后按Enter键

安装程序将自动执行以下操作：

• 安装 家酿 （如果未安装）
• 安装 Node.js （如果未安装）
• 安装所有依赖项并构建服务器
• 配置Claude桌面

注： 如果macOS要求您输入密码，请输入您的Mac登录密码，然后按enter键。这很正常——它正在安装系统包。

选项B：手动设置（macOS）

cd grinfi-mcp-server
npm install
npm run build

然后将此添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "grinfi": {
      "command": "node",
      "args": ["/full/path/to/grinfi-mcp-server/dist/index.js"],
      "env": {
        "GRINFI_API_KEY": "your-api-key-here"
      }
    }
  }
}

______________________________________________________________________

Windows安装

选项A：使用安装程序（推荐）

1. 打开 grinfi mcp服务器 文件资源管理器中的文件夹
2. 双击 install.bat
3. 如果Windows显示安全警告（“Windows保护您的电脑”），请单击 “更多信息” 然后 “无论如何都要运行”
4. 出现提示时，粘贴您的 Grinfi API密钥 然后按Enter键

安装程序将自动执行以下操作：

• 安装 Node.js 通过翼子板（如果未安装）
• 安装所有依赖项并构建服务器
• 配置Claude桌面

选项B：手动设置（Windows）

cd grinfi-mcp-server
npm install
npm run build

然后将此添加到 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "grinfi": {
      "command": "node",
      "args": ["C:/full/path/to/grinfi-mcp-server/dist/index.js"],
      "env": {
        "GRINFI_API_KEY": "your-api-key-here"
      }
    }
  }
}

______________________________________________________________________

安装后（所有平台）

1. 重新启动克劳德桌面 --完全退出（而不仅仅是关闭窗口）并重新打开
2. 寻找 “外国佬” 在工具列表中（聊天底部的锤子图标）
3. 开始聊天！尝试： *“显示我的所有联系人”*

______________________________________________________________________

Claude代码配置

claude mcp add grinfi -- node /full/path/to/grinfi-mcp-server/dist/index.js

然后在运行Claude Code之前设置环境变量：

export GRINFI_API_KEY="your-api-key-here"
claude

______________________________________________________________________

云端点（付费克劳德计划）

如果你有付费的Claude计划，你可以使用我们的托管云端点——不需要本地安装。

访问 mcp.grinfi.io 生成您的个人MCP端点URL。

______________________________________________________________________

可用工具

联系人

列表

自动化

Unibox（消息）

发件人配置文件

CSV导入/导出 *（1.1中新增）*

铅富集和分析 *（1.1中新增）*

自动化文件夹和注册

AI代理和模板——完整的CRUD *（1.1中新增）*

闭包 *（1.1中新增）*

失败的任务分类 *（1.2中新增）*

工作区仪表板和健康状况 *（1.2中新增）*

LinkedIn浏览器 *（1.2中新增）*

数据源（LinkedIn导入作业） *（1.2中新增）*

客户和团队 *（1.2中新增）*

集成和诊断 *（1.2中新增）*

______________________________________________________________________

对话示例

查找联系人：

“通过电子邮件查找联系人john@example.com"

使用筛选器搜索：

“显示2024年1月后创建的谷歌联系人”

管理自动化：

“列出我的自动化并启动名为CMO Germany的自动化”

发送消息：

“向Anna发送一条LinkedIn消息，说我们有一个新的案例研究”

______________________________________________________________________

故障排除

“未设置GRINFI_API_KEY”

请确保已配置API密钥。重新运行安装程序或手动编辑Claude Desktop配置文件（请参阅上面的“手动设置”部分）。

工具未在Claude中显示

1. 确保克劳德桌面 完全重新启动 （退出并重新打开，而不仅仅是关闭窗口）
2. 检查配置文件路径是否适合您的操作系统
3. 确保路径 dist/index.js 是绝对的（以开头 / 在Mac或 C:\ 在Windows上）

API错误（401/403）

您的API密钥可能无效或已过期。在中生成一个新的 Grinfi→ 设置→ API密钥.

构建错误

cd grinfi-mcp-server
rm -rf node_modules dist
npm install
npm run build

安装程序无法启动（Mac）

如果双击不起作用，请打开终端并运行：

bash /Users/yourname/Documents/grinfi-mcp-server/install.sh

安装程序无法启动（Windows）

确保您正在双击 install.bat （不是 install.ps1).如果Windows阻止它，请单击“更多信息”→ “无论如何都要跑”。

如果不起作用，请手动打开PowerShell（按 Win + X，选择“PowerShell”），然后运行：

cd "$HOME\Documents\grinfi-mcp-server"
powershell -ExecutionPolicy Bypass -File install.ps1

______________________________________________________________________

需求

• Node.js 18+ --由安装程序自动安装，或 手动下载
• 克劳德桌面版 — 在这里下载
• Grinfi.io帐户 带有API密钥

______________________________________________________________________

许可证

麻省理工学院