iReceipt.pro

iReceipt.pro — MCP 配置

通过我们托管的 Model Context Protocol (MCP) 服务，将 AI 助手连接到你的 iReceipt.pro 账户。iReceipt.pro 通过 REST API 将 HTML（Mustache）模板渲染为 PDF、PNG、JPG 和 WEBP；MCP 服务可让助手为你编写并检查这些模板。无需本地配置，也无需 API 密钥——该服务是远程服务，并受 OAuth 2.1 保护，因此你只需使用 iReceipt.pro 账户登录一次。

• 服务： ireceipt-pro
• 传输方式： 可流式传输的 HTTP
• URL： https://mcp.ireceipt.pro/mcp
• 身份验证： OAuth 2.1（授权码 + PKCE）——系统会提示你登录。

你可以做什么

连接后，助手可以使用你的私有模板和公共图库，在使用模板前进行检查，并渲染预览：

工具	功能
list_templates	列出你的私有模板和／或公共图库（ID、名称、页面尺寸）。
get_template	获取模板的 HTML、示例参数和页面框。
create_template	创建私有模板（不超过你套餐的模板数量上限）。
update_template	部分更新私有模板。
delete_template	永久删除私有模板。
validate_template	免费静态检查：Mustache 语法、变量和渲染器陷阱（不允许脚本和网络访问）。
preview_template	将已保存或未保存的 HTML 渲染为图像。会占用每月配额中的一次请求。
get_template_guide	按主题获取模板编写指南。

---

在 Claude Code 中安装（插件）

/plugin marketplace add ireceipt-pro/mcp-setup
/plugin install ireceipt-pro@ireceipt-pro
/reload-plugins

然后运行 /mcp，并按提示完成登录。

不想使用市场？直接添加该服务：

claude mcp add --transport http ireceipt-pro https://mcp.ireceipt.pro/mcp

---

从其他客户端连接

远程 URL 和登录方式相同——只有配置位置不同。

Claude Desktop / claude.ai 连接器

1. 打开设置 → 连接器 → 添加自定义连接器。
2. 名称：iReceipt.pro
3. URL：https://mcp.ireceipt.pro/mcp
4. 保存，然后连接并按提示登录。

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（每个项目）：

{
  "mcpServers": {
    "ireceipt-pro": {
      "url": "https://mcp.ireceipt.pro/mcp"
    }
  }
}

VS Code（GitHub Copilot / MCP）及其他客户端

{
  "servers": {
    "ireceipt-pro": {
      "type": "http",
      "url": "https://mcp.ireceipt.pro/mcp"
    }
  }
}

---

身份验证

该服务实现了 OAuth 2.1，支持：

• 授权码授权 + PKCE (S256)、刷新令牌。
• 动态客户端注册（RFC 7591）——客户端会自动注册。
• 作用域：templates:read、templates:write、templates:render、offline_access。
• 发现文档：
  • https://mcp.ireceipt.pro/.well-known/oauth-protected-resource
  • https://mcp.ireceipt.pro/.well-known/oauth-authorization-server
  • https://mcp.ireceipt.pro/.well-known/openid-configuration

同意授权的页面会显示在 dashboard.ireceipt.pro。令牌会发放给你的账户——助手只能查看和更改你的模板。若要断开某个助手，请在控制面板中打开 Agents，然后点击 Forget。

此外还提供引导式提示词（create_template、fix_template、template_guide）和 template-guide 资源，因此助手可以自行找到合适的工作流。

---

故障排除

• 401 Unauthorized / 被要求重新登录——访问令牌已过期。重新执行客户端的连接／授权操作。
• 未显示工具——确认客户端已完成 OAuth 流程（在 Claude Code 中，/mcp 应显示该服务为已连接）。
• 预览失败并提示配额不足——preview_template 会计入你的套餐配额；validate_template 免费，并可提前发现大多数问题。
• 账户错误——在控制面板中断开连接（Agents → Forget），然后重新连接。

支持

• 网站：https://ireceipt.pro
• 控制面板：https://dashboard.ireceipt.pro
• API 文档：https://api.ireceipt.pro
• 支持邮箱：[email protected]