Tupana

Tupana MCP

Tupana 的远程 MCP 服务：将 Claude、ChatGPT、Cursor 或任何兼容的 Agent 连接到你的智利电子开票（SII）、催收、银行对账和销售报告。

https://mcp.tupana.ai/mcp

• 传输方式： Streamable HTTP。
• 身份验证： OAuth 2.1，支持 PKCE 和动态客户端注册。连接时，客户端会打开浏览器，让你登录 Tupana 并授权访问。无需复制任何 API key。
• Scopes： tupana:read 和 tupana:write。
• 隐私： 每位用户只能查看自己在 Tupana 中有权访问的企业；所有工具都会在该范围内解析单据和企业。
• 安全性： 不可逆操作（向 SII 开票、发送邮件、对账）都设计为需要确认。开票是单独的一步：Agent 会创建草稿，向你展示 PDF 预览，只有在你确认后，才会通过 emit_document 开票。

还没有账户？前往 developers.tupana.ai 创建。

你可以这样提问

• “我这个月开了多少发票？最大的 10 个客户是谁？”
• “给 76.123.456-7 开一张发票，内容为 3 小时咨询服务，单价 $45.000 + IVA，注明采购订单 4500123。”
• “有哪些发票逾期超过 30 天还未收款？”
• “将昨天的银行流水与匹配的发票进行对账。”
• “显示 9 月的 IVA 汇总和 F29。”
• “为这个 SaaS 添加智利电子开票功能。”（MCP 也会指导你构建集成）

连接

Claude（claude.ai 和 Claude Desktop）

1. 前往 Settings → Connectors → Add custom connector。
2. 名称：Tupana。URL：https://mcp.tupana.ai/mcp。
3. 点击 Connect，登录 Tupana 并授权。

在 Team 和 Enterprise 计划中，管理员可以为整个组织添加连接器。

Claude Code

claude mcp add --transport http tupana https://mcp.tupana.ai/mcp

然后，在 Claude Code 中运行 /mcp，选择 tupana 并在浏览器中完成登录。要与团队共享，可使用 --scope project 添加（配置会保存在 .mcp.json 中）。

Cursor

在 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）中：

{
  "mcpServers": {
    "tupana": {
      "url": "https://mcp.tupana.ai/mcp"
    }
  }
}

Cursor 会检测到服务请求 OAuth，并显示登录按钮。

ChatGPT

1. 启用 Settings → Apps & Connectors → Advanced settings → Developer mode（是否可用取决于你的计划）。
2. 在 Apps & Connectors 中，使用 URL https://mcp.tupana.ai/mcp 创建新的连接器，并选择 OAuth 身份验证。
3. 使用你的 Tupana 账户授权，并在聊天中启用该连接器。

VS Code（GitHub Copilot）

在 .vscode/mcp.json 中：

{
  "servers": {
    "tupana": {
      "type": "http",
      "url": "https://mcp.tupana.ai/mcp"
    }
  }
}

其他客户端

任何支持远程 MCP（Streamable HTTP + OAuth 2.1）的客户端都可以使用同一个 URL。服务会在以下地址发布元数据：

• https://mcp.tupana.ai/.well-known/oauth-protected-resource
• https://mcp.tupana.ai/.well-known/oauth-authorization-server

如果你的客户端仅支持 stdio，可使用 mcp-remote 等桥接工具：

{
  "mcpServers": {
    "tupana": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tupana.ai/mcp"]
    }
  }
}

通过你自己的 Agent 使用

tupana-ai/tupana-examples 中提供了一个 Python Agent（Claude API + MCP 客户端），开票前会请求你的确认。

工具

文档与开票

工具	功能
get_documents	查询税务文档（发票、收据、贷项通知单……）。
search_documents	按客户、金额或 folio 搜索已开具的文档。
get_document_link	获取已开具文档的链接（PDF）。
create_sale_invoice	创建应税（33）或免税（34）发票的草稿，并附上参考信息（OC 801、HES）。
create_purchase_invoice	创建采购发票（46）草稿。
create_export_invoice	创建出口发票（110）草稿。
create_receipt	创建收据（39 或 41）草稿。
create_fee_receipt	创建劳务费收据草稿。
create_dispatch_guide	创建发货单（52）草稿。
create_credit_note	创建引用发票的贷项通知单（61）（用于作废或更正）。
create_debit_note	创建引用发票的借项通知单（56）。
parse_spreadsheet_to_invoices	将电子表格转换为发票草稿（批量开票）。
get_document_preview / get_document_previews	预览一个或多个草稿的 PDF，供你审核。
emit_document / emit_documents	将一个或多个已审核的草稿提交至 SII。必须先预览。
send_document_email	通过电子邮件转发已开具的文档。
create_scheduled_invoice	创建定期发票。
get_scheduled_documents	列出已安排的文档。
parse_document_to_invoice	从采购订单或 PDF 中提取项目，以便开票。

客户、供应商与公司

工具	功能
get_entity_info	查看你在 Tupana 的公司。
find_clients	搜索客户（接收方）。
enrich_client_from_rut	根据 RUT 获取纳税人在 SII 的信息。
get_suppliers	根据已收到的采购发票查询供应商。
get_top_clients	按开票金额或数量排列的客户排名。
get_top_products	已售产品或项目排名。
get_cross_sell_clients	购买了某种产品但未购买另一种产品的客户。

报告、账簿与税务

工具	功能
report_documents	按月、类型、客户或状态统计已开具文档的总数。
get_monthly_revenue	月度销售额序列。
get_sii_books	SII 采购与销售账簿。
get_f29_summary	本期 F29 摘要。
get_tax_summary	进项税额与销项税额摘要。

催收与银行对账

工具	功能
get_pending_invoices	待付款发票（应收账款与应付账款）。
get_bank_movements	银行交易及其对账状态。
get_payment_documents	付款文档（类型 100）。
get_reconciliation_suggestions	带自动评分的对账建议。
reconcile_movement	将一笔交易与一张或多张发票进行对账。
get_reconciliations	对账历史记录。

发票转让（保理）

工具	功能
prepare_cession	准备将已开具的发票转让给保理机构。
execute_cession	在 SII 中执行已准备并审核的转让。
get_cession_status	查询转让状态。

SII 企业公开数据库

工具	功能
search_sii_companies	在 SII 公开名录中搜索智利企业。
find_sii_prospects	按行业、地区和规模寻找潜在客户。
find_growing_sii_companies	查找两年间实现增长的企业。
get_sii_company_history	查询企业在名录中的发展历程。
get_sii_market_summary	查看市场规模（企业与员工人数）。
get_sii_companies_metadata	查看可用筛选条件（年份、规模区间、地区、行业）。

在 SaaS 中构建开票功能

工具	功能
get_capabilities	Tupana 能做什么，以及从哪个工具开始。
get_invoice_flow	完整的开票流程，逐步说明。
get_invoice_ui_spec	前端规范（字段、类型、条件）。
get_invoice_validation_schema	按步骤和字段划分的草稿验证规则。
validate_invoice_draft	使用与 API 相同的规则验证草稿。
get_customer_lookup_flow	从 RUT 查询企业名称、业务活动和地址。
get_invoice_item_rules	发票明细行规则。
get_invoice_reference_rules	根据单据类型确定的引用规则。
get_invoice_preview_flow	如何请求并显示预览。
get_invoice_issuance_flow	如何开具发票、有哪些状态以及会返回什么。
get_async_strategy	根据你的技术栈选择 Webhook + WebSocket 或轮询。
get_integration_setup	API key、注册、Webhook 和沙盒。
get_invoice_contract_findings	哪些规则已在代码中确认，哪些是声明的。
get_error_resolution	Tupana 或 SII 错误的含义及处理方法。
get_design_system	Tupana 的 design system 令牌。

企业连接与导航

工具	功能
get_tupana_connect_guide	如何使用 Tupana Connect 注册企业。
open_tupana_connect	打开 Tupana Connect 并返回链接（SII 开票、SII 数据读取或银行）。
get_app_link	直接链接到通过界面操作的应用页面。
get_app_guide	应用导航指南。
list_capabilities	回答“你能做什么？”。
how_to	完成任务的分步教程。

此列表反映的是本仓库发布时的服务端状态。权威信息以服务端自身的 tools/list 为准。

目录

• 官方 MCP Registry： server.json（io.github.tupana-ai/tupana）。要发布或更新，请运行工作流 发布到 MCP Registry（Actions → Run workflow）；该工作流使用 GitHub OIDC 进行身份验证。或者，也可以在你的计算机上运行：

  brew install mcp-publisher
  mcp-publisher login github   # con una cuenta miembro de la organización tupana-ai
  mcp-publisher publish
  

• Glama： glama.json 声明了维护者。Glama 将此仓库索引为服务端（glama.ai/mcp/servers/tupana-ai/tupana-mcp），并将远程端点索引为连接器（glama.ai/mcp/connectors/io.github.tupana-ai/tupana）。

• Smithery： 通过 URL 在 smithery.ai/new 发布（或运行 smithery mcp publish "https://mcp.tupana.ai/mcp" -n @tupana/tupana）；仓库中无需配置文件。

资源

• 文档：docs.tupana.ai
• 开发者门户：developers.tupana.ai
• 官方 SDK：Node.js npm install tupana（npm · GitHub）· Python pip install tupana（PyPI · GitHub）
• 示例：tupana-ai/tupana-examples
• 支持：[email protected]

许可证

本仓库的文档和文件采用 MIT 许可证。MCP 服务由 Tupana 托管。

---

英文摘要

Tupana 的远程 MCP 服务：支持智利电子发票（SII）、催款、银行对账、销售报告和发票转让，地址为 https://mcp.tupana.ai/mcp（Streamable HTTP、OAuth 2.1，支持 PKCE 和动态客户端注册；权限范围为 tupana:read / tupana:write）。在 Claude 中将其添加为自定义连接器；在 Claude Code 中运行 claude mcp add --transport http tupana https://mcp.tupana.ai/mcp；在 Cursor 或 VS Code 中通过 mcp.json 配置；或在 ChatGPT 中将其添加为开发者模式连接器。对于不可撤销的操作（向 SII 开具发票、发送电子邮件、对账），系统会要求确认：Agent 会创建草稿并显示 PDF 预览，只有在你批准后才会通过 emit_document 开具。注册表元数据位于 server.json（io.github.tupana-ai/tupana）。