Anchord MCP

固定MCP服务器

AI代理的身份解析和预写安全检查。

](https://www.npmjs.com/package/@anchord/mcp-server) 

一 主控程序 允许AI代理访问的服务器 到 锚定 身份解析API。解决 公司和个人使用规范的AnchorID，运行预写安全检查， 并通过标准MCP工具界面导出金唱片。

托管API支持。 此MCP服务器是Anchord SaaS的瘦代理 平台。所有的评分、匹配、验证和数据持久化都会发生 服务器端。没有业务逻辑在本地运行。

按设计只读。 锚定永远不会写入您的外部系统 （CRM、数据库等）。 guard_write 评估拟议的写作和 返回allowed/blocked——调用者决定是否继续。

______________________________________________________________________

快速开始

1.获取API密钥

注册地址： app.anchord.ai/注册 和 在中创建API密钥 设置>API密钥.

2.使用npx运行（无需安装）

ANCHORD_API_KEY= npx -y @anchord/mcp-server

就是这样。服务器通过stdio启动，并为MCP客户端做好准备。

3.或连接到托管的远程（零安装）

无需本地安装。指向任何支持远程HTTP的MCP客户端 托管端点处的传输：

{
  "mcpServers": {
    "anchord": {
      "url": "https://mcp.anchord.ai/mcp",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

看 docs/remote.md 有关详细信息，客户 兼容性说明，如果您的客户端尚未提供，则提供本地回退 支持远程MCP。

______________________________________________________________________

MCP客户端设置

光标（本地stdio）

添加 .cursor/mcp.json （工作空间）或 ~/.cursor/mcp.json （全球）：

{
  "mcpServers": {
    "anchord": {
      "command": "npx",
      "args": ["-y", "@anchord/mcp-server"],
      "env": {
        "ANCHORD_API_KEY": ""
      }
    }
  }
}

看 examples/cursor-mcp.json.

克劳德桌面

添加到您的Claude桌面配置 (~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上， %APPDATA%\Claude\claude_desktop_config.json 在Windows上）：

{
  "mcpServers": {
    "anchord": {
      "command": "npx",
      "args": ["-y", "@anchord/mcp-server"],
      "env": {
        "ANCHORD_API_KEY": ""
      }
    }
  }
}

看 examples/claude-desktop-config.json.

远程MCP（适用于支持HTTP传输的客户端）

对于零安装远程访问，请使用托管端点而不是 本地stdio进程。这适用于支持以下功能的任何MCP客户端 url + headers 配置格式：

{
  "mcpServers": {
    "anchord": {
      "url": "https://mcp.anchord.ai/mcp",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

无需Node.js、npx或Docker。如果你的客户还没有 支持远程MCP，请使用上面的本地stdio设置。 看 docs/remote.md 了解全部细节。

码头工人

docker build -t anchord-mcp .
echo '{"jsonrpc":"2.0","id":1,"method":"initialize",...}' | \
  docker run --rm -i -e ANCHORD_API_KEY= anchord-mcp

或者使用compose文件进行本地测试：

cp examples/env.example .env
# Edit .env with your API key
docker compose up

______________________________________________________________________

环境变量

看 docs/auth.md 有关身份验证和租户的详细信息 范围界定。

______________________________________________________________________

可用工具

完整参数参考： docs/tools.md

______________________________________________________________________

安全代理工作流程

代理写入外部系统的推荐顺序：

1. ingest_record        Push the source record into Anchord
                        (optional if using OAuth integrations)

2. resolve_company      Match to a canonical AnchorID
   or resolve_person    → status: resolved | not_found | needs_review

3. IF needs_review      STOP. Do not write.
                        Surface candidates to the user.
                        Direct them to the Review Queue.

4. guard_write          Evaluate the proposed write
                        → allowed: true | false (with block codes)

5. IF allowed           The agent performs the external write.
                        Anchord never writes.

6. Log request_id       Every response includes a request_id
                        for audit trail and debugging.

使用 get_entity 或 get_entity_export 在任何时候检查AnchorID 详细信息或检索合并的金唱片。

______________________________________________________________________

处理 needs_review

仅 resolve_* 回报 needs_review.这意味着锚定发现多个 看似合理的匹配，无法自信地自动解决。

对于代理商：

1. 不要写。 数据不明确。
2. 展示候选人 对于用户，响应包括实体ID

以及比赛成绩。

1. 将用户引导到审阅队列：

https://app.anchord.ai/app/queues/needs-review

1. 请稍后重试。 一旦人类解决了歧义，后续解决

呼叫返回 resolved.

代理消息示例：

我试图解决“Acme Corp”问题，但Anchord发现了多个可能的匹配。 人类需要在 审核队列. 我会在问题解决后重试。

______________________________________________________________________

错误处理

当API返回4xx/5xx时，MCP工具响应被标记 isError: true 具有结构化有效载荷：

{
  "error": "[422] BATCH_TOO_LARGE: Batch size must not exceed 100 records. (request_id: req_01ABC123)",
  "status_code": 422,
  "request_id": "req_01ABC123",
  "details": { "records": ["Too many records."] }
}

• request_id 始终存在-来自API响应主体， x-request-id

例如用户名、标头或客户端生成的UUID。

• details 包含验证错误（非JSON错误为null）。
• API密钥从不包含在错误消息中。

______________________________________________________________________

建筑

本地（stdio）

MCP Client (Cursor / Claude Desktop / etc.)
    │  stdio (JSON-RPC)
    ▼
┌──────────────┐
│  MCP Server  │  Node.js + TypeScript
│  (this pkg)  │  Zod schemas · no business logic
└──────┬───────┘
       │  HTTPS + Bearer auth
       ▼
┌──────────────┐
│  Anchord API │  Hosted SaaS — scoring, matching,
│              │  persistence, tenant isolation
└──────────────┘

托管远程（HTTP）

MCP Client
    │  HTTPS POST + Bearer token
    ▼
┌────────────────────────┐
│  mcp.anchord.ai        │  CloudFront (TLS, routing)
└───────────┬────────────┘
            ▼
┌────────────────────────┐
│  Lambda (stateless)    │  Per-request MCP server
│  Bearer → ApiClient    │  No stored secrets
└───────────┬────────────┘
            │  HTTPS + Bearer auth
            ▼
┌────────────────────────┐
│  Anchord API           │  Same hosted SaaS backend
└────────────────────────┘

两条路径都暴露了相同的11个MCP工具，并连接到相同的API。

______________________________________________________________________

常见问题解答

Anchord是自托管的吗？

不是。Anchord是一个托管的SaaS平台。此MCP服务器是瘦客户端 调用锚定API。您需要来自的API密钥 app.anchord.ai/注册.

Anchord会写入我的CRM吗？

否。锚定是严格只读的。它从连接的系统读取数据 （Salesforce、HubSpot、Stripe）构建身份图，但从不写 \< 返回 guard_write 返回一个决策——调用者执行任何实际的写入操作。

Anchord适用于哪些系统？

Anchord集成了OAuth 销售人员, 集客，以及 条纹。您还可以通过以下方式从任何系统推送记录 ingest_record 工具或REST API。

当出现歧义时会发生什么？

当 resolve_* 回报 needs_review，这意味着有多名候选人 AnchorID匹配的置信度相似。药剂应停止，浮出水面 将候选人发送给人类，并将他们引导到锚定审查队列。 一旦解决，后续呼叫将返回 resolved.

利率限制是什么？

每位租户每分钟120个请求。批处理端点最多可接受200个项目 （解析、保护）或100条记录（摄取）。计划级别月度和每日 配额适用。看 docs/auth.md.

______________________________________________________________________

链接

• 锚定网站
• 注册
• API文档（Swagger）
• 代理快速入门
• 工具参考
• 认证

______________________________________________________________________

许可证

麻省理工学院