# ConnectMachine 的 MCP 服务器

ConnectMachine 提供远程 MCP 服务器，任意兼容 MCP 的 AI 工具都能通过自然对话管理你的联系人、活动、人脉分组和电子名片。无需安装任何东西：工具用你的个人密钥通过 HTTPS 连接。

✓ConnectMachine 账户已包含。少数高级操作遵循与应用内相同的高级版规则。

## 服务器提供哪些工具

服务器发布 40 个专用工具。助理会为每个请求选择合适的工具，你无需按名称调用。

- **联系人（12 个工具）**：列表、读取、查找、创建、更新、删除、智能搜索、行业、计数、重复项、合并以及分配到人脉分组。
- **活动（3 个工具）**：列出你的活动，并为联系人关联或取消关联认识对方的活动。
- **人脉分组（5 个工具）**：列表、创建、更新、删除和重新排序。
- **电子名片（7 个工具）**：列表、读取、创建、更新、删除、读取共享名片，以及从名片照片中提取联系人信息。
- **导入与导出（6 个工具）**：批量导入任务、进度跟踪和 CSV 导出。
- **通知与个人资料（7 个工具）**：通知、未读计数、个人资料和订阅状态。

**重要**

AI 查询与会议转录工具尚未开放，将在后续阶段推出。

## 获取 MCP 密钥

密钥是与你的 ConnectMachine 账户绑定的个人 bearer token。打开 MCP 连接页面，用账户邮箱（一次性验证码）或 Google 登录。页面会显示你的密钥，以及常用工具的现成配置片段。密钥由后端管理且不会过期；请妥善保密，若要断开连接，只需从工具中删除该配置。

- 连接页面：[licenses.connectmachine.ai/mcp/auth](https://licenses.connectmachine.ai/mcp/auth)
- AI 工具发出的每个请求都用这个密钥验证，且仅限你自己的账户。

## 连接 Claude

Claude 在网页版、桌面版和 Claude Code 中都支持远程 MCP 服务器。网页版和桌面版：打开设置，然后连接器，选择添加自定义连接器，并粘贴服务器 URL。Claude Code：在项目根目录创建 .mcp.json，填入下面的片段（把 YOUR_MCP_KEY 替换为你的密钥），然后重启 Claude Code。

```json
{
  "mcpServers": {
    "connectmachine": {
      "type": "http",
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}
```

## 连接 Cursor

创建或编辑 ~/.cursor/mcp.json（全局）或项目内的 .cursor/mcp.json，粘贴下面的片段，并把 YOUR_MCP_KEY 替换为你的密钥。重新加载 Cursor，ConnectMachine 工具就会出现在 MCP 列表中。

```json
{
  "mcpServers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}
```

## 连接 VS Code

VS Code 使用 servers 对象，而不是 mcpServers。在工作区中创建 .vscode/mcp.json，粘贴下面的片段，并把 YOUR_MCP_KEY 替换为你的密钥。

```json
{
  "servers": {
    "connectmachine": {
      "type": "http",
      "url": "https://mcp.connectmachine.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}
```

## 连接 Zed

Zed 把 MCP 服务器称为 context servers，并原生支持远程服务器，因此无需安装扩展。打开 Settings，然后 AI，再进入 MCP Servers，点击 Add Server 并选择 Add Remote Server，或者把下面的片段粘贴到 Zed 的 settings.json 中。如果没有 Authorization 头，Zed 会执行标准的 MCP OAuth 流程，并在首次使用时要求你登录；若你更希望使用静态令牌，可添加带有密钥的 "headers" 对象。

```json
{
  "context_servers": {
    "connectmachine": {
      "url": "https://mcp.connectmachine.ai/mcp"
    }
  }
}
```

## 其他 MCP 客户端

任何支持远程 HTTP MCP 服务器的客户端都能接入，只需两个值：服务器 URL，以及在 Authorization 头中以 bearer token 形式发送的密钥。实现了 MCP OAuth 流程的客户端也可以通过浏览器登录；服务器支持 OAuth 2.0、动态客户端注册和 PKCE。

- 服务器 URL：https://mcp.connectmachine.ai/mcp
- 认证头：Authorization: Bearer YOUR_MCP_KEY

## 工具的行为方式

服务器的设计目标是让助理无法在你不知情的情况下对人脉数据做错事。

- **同名保护**：当两个联系人同名时，find_contact 会报告这种歧义，并要求助理向你确认指的是哪一位，而不是自行猜测。
- **用活动而非标签**：整理方式与应用保持一致。你关联的是认识对方的活动，服务器不提供自由标签。
- **智能搜索覆盖**：姓名、公司、职位、邮箱、电话、备注、地点、见面地点和活动名称。
- **新账户**：在应用内完成引导之前，工具会返回操作提示和应用下载链接，而不是空结果。

## 套餐与高级版操作

连接 AI 工具已包含在 ConnectMachine 中。在应用内属于高级版的操作，通过 MCP 同样属于高级版，例如 CSV 导出以及按行业或地点筛选。免费账户触发这类操作时，工具会返回明确的说明，指出对应功能和升级方式，绝不会静默失败。

## 隐私与安全

MCP 服务器是一个轻量的、需要认证的桥梁，连接到 ConnectMachine API。它不保存你的人脉数据副本。

- 每个请求都会针对你的账户校验密钥；不存在跨账户访问。
- 助理只会拿到回答具体请求所需的数据。
- 随时可以断开连接：从工具中删除该配置即可。
- **条款与隐私**：[connectmachine.ai/zh/legal/terms-of-service](/content/zh/legal/terms-of-service/index.html) 和 [connectmachine.ai/zh/legal/privacy](/content/zh/legal/privacy/index.html)。

## 故障排查

大多数连接问题都出在 URL、密钥或账户状态上。

- **密钥无效**：重新在连接页面登录，并使用页面显示的密钥。
- **收到引导提示**：先在 ConnectMachine 应用内完成引导，然后再次提问。
- **收到高级版提示**：该操作需要升级套餐，其余功能照常可用。
- **连接失败**：确认 URL 与 https://mcp.connectmachine.ai/mcp 完全一致，并在修改配置后重启 AI 工具。

现在就来创建你的电子名片