item MCP Server

什么是 item MCP Server？

item MCP Server 是官方托管端点，将 AI 客户端连接到你的 item 工作区，让 Claude、ChatGPT、Cursor 或 Codex 可以搜索 CRM 记录、向 item 助手提问，并更新笔记、任务和列表。

item 将自己描述为一个 AI 原生系统，能够理解你的业务、了解你的客户并完成工作，旨在取代你的 CRM。它提供表格、看板和自定义对象、数据补全、线索发现，以及根据书面流程文档构建的 AI 智能体。item MCP 服务器通过 https://mcp.item.app/mcp 把这个工作区接入 Model Context Protocol 客户端，并使用 OAuth，让每位用户用自己的 item 账号登录。

如何使用 item MCP Server？

你需要一个拥有有效应用访问权限的 item 账号；item 文档说明 MCP 访问遵循与网页应用相同的计费规则。item 目前通过官网的候补名单接纳新客户。

服务器 URL 为：

https://mcp.item.app/mcp

如果客户端要求选择传输方式，请选择 HTTP、Streamable HTTP 或 Remote HTTP。登录在浏览器中完成：客户端会打开 item 授权页面，你用想使用的账号登录，查看所请求的权限并允许访问。

Claude Code

claude mcp add --transport http item https://mcp.item.app/mcp

启动 Claude Code，运行 /mcp，选择 item 并完成浏览器中的 OAuth 流程。若要在所有项目中使用 item，请加上 --scope user：

claude mcp add --transport http --scope user item https://mcp.item.app/mcp

Claude Desktop 和 claude.ai

在 Pro 或 Max 套餐中，进入 Customize > Connectors，点击 +，选择 Add custom connector，名称填 item，URL 填 https://mcp.item.app/mcp。除非管理员给了你具体值，否则高级 OAuth 客户端字段留空，然后点击 Connect。在 Team 和 Enterprise 套餐中，可能需要组织 Owner 先在 Organization settings > Connectors 中添加该连接器。

Cursor

将以下内容添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目），重启 Cursor，并在 MCP 设置中连接：

{
  "mcpServers": {
    "item": {
      "url": "https://mcp.item.app/mcp"
    }
  }
}

VS Code

添加到 .vscode/mcp.json；服务器启动时 VS Code 会提示你登录：

{
  "servers": {
    "item": {
      "type": "http",
      "url": "https://mcp.item.app/mcp"
    }
  }
}

Codex

codex mcp add item --url https://mcp.item.app/mcp

item MCP Server 的主要功能

• 官方托管：item 官方提供该服务器的文档，无需在本地安装或运行任何东西。
• 按用户 OAuth 授权：每个人连接自己的 item 账号；可用工具取决于该账号的权限和已连接的集成。
• 只读助手：根据 item 文档，ask_item_assistant 可回答需要跨对象类型、邮件、会议、会议录音和时间线进行分析的复杂问题，并返回用于后续追问的 thread_id。
• 结构化 CRM 访问：文档列出了搜索和获取对象、列出对象类型、读取 schema，以及创建、更新或删除 CRM 对象的工具。
• 视图和列表：运行带有筛选和排序的已保存视图，浏览、创建和编辑列表。
• 笔记和任务：创建和编辑笔记，为 AI 或用户搜索、创建、更新或删除任务。
• 有意限制范围：item 表示，外部消息、日历写入、Slack 和 LinkedIn 发送、会消耗点数的数据补全、原始 SQL、批量修改和技能触发都不会作为 MCP 工具开放。

item MCP Server 的使用场景

• 销售管道提问：“问问 item 本周哪些交易推进了阶段，以及每笔交易上次会议讨论了什么。”
• 编码或写作时查询记录：“在 item 中找到 Acme 公司并显示它的自定义字段。”
• 通话跟进：“这个联系人最近一次记录的电话是什么？”然后“创建一条总结后续步骤的笔记。”
• 任务管理：“为我创建一个任务，下周二跟进这个线索。”
• 建立列表：“运行我的 'Hot leads' 视图，并把前十家公司加入一个新列表。”

item MCP Server 常见问题排查

• 浏览器中显示“Missing authorization”：直接打开 https://mcp.item.app/mcp 会出现这个错误。这是正常的，请通过 MCP 客户端连接。
• 浏览器没有打开：复制客户端输出的授权 URL，手动打开。
• 连接了错误的账号：在客户端中移除或断开该服务器，重新添加并用正确的 item 账号登录。
• 登录前提示“Unauthorized”：在客户端中重试连接。首次未认证请求正是客户端发现 item OAuth 配置的方式。
• 客户端只支持 stdio：无法直接连接，需要一个能通过 HTTP 与 item 通信的远程 MCP 桥接或代理。