开发者

三套接口：AI 大模型版本查询免密钥直接 GET；时间日历 API 与 MCP 需要密钥、按调用扣积分。左侧选一节，右侧每个接口都能填密钥直接试。

MCP 接入方式

端点 https://handapp.com/api/mcp，Streamable HTTP 传输。 在 Claude Desktop、Claude Code 或任何支持 MCP 的客户端里这样配：

{
  "mcpServers": {
    "handapp-calendar": {
      "url": "https://handapp.com/api/mcp",
      "headers": { "Authorization": "Bearer ha_pat_xxx" }
    }
  }
}

握手（initialize）与列工具（tools/list）不需要密钥、也不扣积分 —— 客户端每次连接都要问一遍，为这个收费没有道理，而且拦下来会让「配置到底对不对」很难排查。 真正取数据的 tools/call 才校验密钥并扣费，每次 1 积分。

工具参数写错时返回的是 isError 而不是协议级错误 —— 前者助手能读到原因并自己改参数重试，后者多半直接断开连接。

tools/list

列出全部工具。无需密钥，可以拿它确认端点通不通。

POST /api/mcp