Nynch Mcp Server

Nynch MCP 服务

网站： www.nynch.com · 开发者文档： www.nynch.com/developers · 端点： https://app.nynch.com/mcp

Nynch 官方托管的 Model Context Protocol 服务。Nynch 是面向顾问和兼职高管的 AI CRM，帮助他们通过关系赢得高价值交易。

涵盖 6 个类别的 50 个工具：CRM 读取、CRM 写入、关系洞察、公司洞察、上下文查询和多 Agent 编排。

端点

https://app.nynch.com/mcp

**传输方式：**通过 Streamable HTTP 传输 JSON-RPC 2.0。该服务是无状态的（无需管理会话），并会与客户端协商协议版本——支持 2025-11-25、2025-06-18 和 2025-03-26。

旧端点 https://crcrwtjzqzinfzokianr.supabase.co/functions/v1/mcp-server 仍可用，但已弃用。请在新配置中使用 https://app.nynch.com/mcp。

快速开始

Claude（自定义连接器、OAuth、无需 API 密钥）

在 Claude 中，打开 Settings → Connectors → Add custom connector，然后输入 https://app.nynch.com/mcp。点击 Connect，使用 Nynch 账号登录并批准访问。你可以随时在 Nynch 的 Settings → Integrations → AI hosts 下撤销访问权限。

其他 MCP 客户端（API 密钥）

1. 获取 API 密钥

在 www.nynch.com 注册，然后前往 Settings → Integrations → Claude & AI Assistants 并创建 API 密钥。

权限范围：

• read — 搜索、浏览和检索数据
• read-write — 读取，以及创建、更新和删除记录
• admin — 完全访问权限，包括 Agent 编排

2. 配置客户端

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "nynch": {
      "url": "https://app.nynch.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "nynch": {
      "url": "https://app.nynch.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Python（MCP SDK）

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client(
    "https://app.nynch.com/mcp",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        result = await session.call_tool("search_contacts", {"query": "Acme Corp"})
        print(result)

3. 开始使用工具

你的 AI 客户端会自动发现可用工具。你可以让它搜索联系人、查看销售管道、创建任务或分析关系。

工具目录

CRM 读取（11 个工具）

工具	描述
search_contacts	按姓名、公司或标签搜索联系人
get_contact_context	联系人的完整上下文：个人资料、互动、活动、备注和人脉网络
search_deals	按标题、阶段或公司搜索交易
get_deal_context	交易的完整上下文：利益相关者、经验总结和辅导行动
search_deals_by_inactivity	查找近期没有活动的停滞交易
get_pipeline_summary	销售管道状况：阶段分布、有风险的交易和即将成交的交易
get_next_best_actions	AI 驱动的下一步行动建议
get_who_list	现在值得联系的人，包括已识别的网站访客。外联时绝不要提及具体页面
list_buckets	列出所有分组（列表/细分）
get_bucket_contacts	获取指定分组中的联系人
get_bucket_game_queue	获取等待归入分组的联系人

CRM 写入（12 个工具）

工具	描述
log_interaction	记录与联系人的互动（电话、电子邮件、会议、备注）
update_deal_stage	将交易移至新的销售管道阶段
create_task	创建与联系人或交易关联的任务
create_note	为联系人添加备注（支持 Markdown）
create_contact	创建新联系人（根据域名自动关联公司）
update_contact	更新现有联系人的字段
add_contact_to_bucket	将联系人添加到分组
create_deal	在销售管道中创建新交易
create_company	创建新公司
delete_contact	软删除联系人（可恢复）
bulk_delete_contacts	按标签或 ID 列表软删除联系人
update_commitment	将承诺标记为已完成或更新其详细信息

关系情报（11 个工具）

工具	描述
get_authority_score	6 个维度的权威度评分
get_commitments	承诺事项，包含言行跟踪和截止日期
get_buying_committee	利益相关者地图：角色、影响力、倾向
get_contact_signals	职位变动、公司变动、购买意向、已识别的网站访问（不含页面路径）
get_interaction_history	完整的互动时间线，包含方向和倾向
get_relationship_score	5 项因素构成的关系强度评分
export_context_briefing	为任意联系人或交易生成适用于 AI 的背景简报
get_relationship_trends	互动是在增长、稳定还是减弱？
get_at_risk_relationships	评分下降或近期没有联系的联系人
get_deal_intelligence	交易健康状况：推进速度、利益相关者覆盖情况、风险因素
get_weekly_briefing	每周摘要：互动、变动、建议

公司情报（3 个工具）

工具	描述
get_firm_warm_paths	您所在公司中认识此人或此公司的人员，按关系强度排序。仅含元数据，绝不包含邮件内容
find_firm_reachable_people	您可以通过同事联系到的人员，按最强关系路径排序，并指出最适合帮忙引荐的同事
get_firm_client_outcomes	公司赢得的客户项目：价值、顾问费、负责人、主要联系人、推荐人，以及按币种统计的总额

Agent 编排（8 个工具）

工具	描述
register_agent	注册具备相应能力和类型的外部 Agent
list_agents	列出已注册的 Agent 及其状态
agent_heartbeat	确认 Agent 仍在运行
write_context	写入共享的 Agent 上下文存储
read_context	从上下文存储中读取（支持前缀通配符）
create_handoff	请求另一个 Agent 执行任务
get_handoffs	获取分配给您 Agent 的待处理交接任务
complete_handoff	将交接任务标记为已完成或失败

上下文查询（5 个工具）

发现并读取 Nynch 及已连接应用的有限范围上下文，优先提供元数据。只读，不接受原始 SQL。

工具	描述
list_context_sources	列出可供您使用的安全只读上下文来源
search_context_sources	按自然语言关键词搜索上下文来源（仅元数据）
describe_context_source	描述一个来源：用途、列、筛选条件、限制、可用性
list_context_columns	列出一个来源中可选的列和允许的筛选条件
query_context	通过受限查询对象读取一个来源中的有限范围数据

MCP 资源

URI 模板	描述
nynch://contacts/{id}	完整联系人上下文：个人资料、评分、互动、关系网络
nynch://deals/{id}	交易上下文：详情、利益相关者、辅导操作
nynch://pipeline/summary	销售管道健康状况概览

Agent 编排

Nynch 支持多 Agent 工作流，AI Agent 可以注册、共享上下文并交接任务：

• 注册：提供名称、能力和类型（执行者、使用者、协调者、评论者）
• 共享状态：通过带有命名空间和 TTL 的键值上下文存储
• 路由任务：按 Agent 名称或能力匹配
• 跟踪运行状态：通过心跳实现

速率限制

• 每个 API 密钥每小时 1,000 个请求

文档

• 开发者文档：www.nynch.com/developers
• MCP 发现：www.nynch.com/.well-known/mcp
• OpenAPI：www.nynch.com/openapi.json

关于 Nynch

Nynch 是面向顾问和兼职高管的 AI CRM，帮助他们凭借关系赢得高价值交易。它会记住邮件、会议和 LinkedIn 中的关系背景，并在值得展开对话时将其呈现出来。

许可证

本仓库（文档和配置）采用 MIT 许可证 发布。Nynch MCP 服务本身是托管服务，无需本地安装。