invitas

invitas MCP 连接器

西班牙语

适用于 invitas.co 的官方 Model Context Protocol（MCP）服务。通过与 Claude、ChatGPT、Cursor 及任何兼容 MCP 的客户端对话，创建、自定义和管理邀请函、宾客名单、RSVP 和座位安排。

连接器端点： https://invitas.co/mcp（Streamable HTTP / JSON-RPC 2.0）

---

架构与交互流程

该连接器通过 Streamable HTTP 和 JSON-RPC 2.0 提供 31 个原生工具，并通过 OAuth 2.1（PKCE）或 Personal Access Token（PAT）验证请求。

sequenceDiagram
    autonumber
    actor User as Host / Developer
    participant Client as MCP Client (Claude / ChatGPT / Cursor)
    participant Connector as invitas MCP Server (https://invitas.co/mcp)
    participant App as invitas.co Core API

    User->>Client: "How many guests confirmed for my event?"
    Client->>Connector: POST /mcp (tools/call: list_guests)
    Connector->>App: GET /api/v1/events/{id}/guests (Bearer Token)
    App-->>Connector: 200 OK (guests & RSVPs payload)
    Connector-->>Client: 200 OK (JSON-RPC tool result)
    Client-->>User: "You have 26 confirmed guests out of 41 invited."

---

工具类别（31 个工具）

所有工具均根据核心 API 规范自动编入目录。有关架构和参数详情，请参阅完整工具目录。

类别	可用工具	必需权限范围
发现与指导	guide、search、fetch	events:read
活动与模板	list_templates、list_events、get_event、create_event、update_event、publish_event、unpublish_event、duplicate_event、export_event	events:read、events:write
媒体与分区	add_event_image、upsert_custom_section、set_custom_fields	events:read、events:write
宾客与 RSVP	list_guests、get_guest、add_guest、update_guest、remove_guest、import_guests、export_guests	guests:read、guests:write
座位与桌位	get_seating_chart、update_seating_chart、assign_guest_table、unassign_guest_table	seating:read、seating:write
通讯与留言墙	list_wall_messages、moderate_wall_message、prepare_reminder、get_event_statistics	events:read、guests:read

---

客户端配置示例

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "invitas": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sse",
        "https://invitas.co/mcp"
      ]
    }
  }
}

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "invitas": {
      "url": "https://invitas.co/mcp"
    }
  }
}

直接 HTTP 请求示例

# Discover available tools
curl -X POST https://invitas.co/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

---

支持的助手

各主流客户端的分步连接指南：

• ChatGPT
• Claude 应用和网页端
• Claude Code
• Codex CLI
• Gemini CLI
• Cursor
• VS Code（GitHub Copilot）
• OpenCode
• Hermes Agent（Nous Research）
• OpenClaw
• Grok（grok.com）
• Grok Build
• 团队版 Grok Bot
• Pi 编码 Agent
• Windsurf / Cascade
• Zed
• Muse Code（Meta）
• 其他 MCP 客户端和终端

---

登录与权限

该连接器使用 Streamable HTTP 和带 PKCE 及动态客户端注册的 OAuth 2.1。收到提示时，请登录 invitas，然后在授权助手之前查看同意页面。

权限	访问权限
events:read	读取活动。
events:write	创建和更新活动。
guests:read	读取宾客信息。
guests:write	添加和更新宾客。
seating:read	读取座位安排。
seating:write	更新座位安排。

支持 OAuth 的终端客户端可以通过上述指南使用浏览器登录。对于支持 bearer 标头的客户端，请在 Mi cuenta 中创建个人访问令牌，选择其权限，并通过 Authorization: Bearer <token> 标头发送。有关连接详情，请参阅其他 MCP 客户端和终端。

---

助手可以看到什么，以及如何断开连接

在你授权的权限范围内，助手可以访问你在控制面板中看到的活动信息，包括宾客联系方式、邀请链接、墙上留言、桌位和已准备的提醒。连接并授权访问后，这些信息可能会与助手提供方共享，例如 Anthropic（Claude）或 OpenAI（ChatGPT）。如需立即终止访问，请打开 Mi cuenta，选择 Apps conectadas，然后选择 Desconectar；已经进行的更改会保留。详情请参阅 数据和权限。

---

示例

请参阅示例对话，了解你可以提出的请求、涉及的工具以及预期结果。

---

链接

• 助手
• 开发者和 REST API · OpenAPI 规范
• 隐私政策 · 子处理方 · 条款
• 帮助 · 支持：[email protected]

---

仓库开发

此仓库包含文档和生成的工具目录；托管连接器运行于 invitas 应用中。安装 Node.js 22 后，运行 npm run check，验证生成的目录文件是否与源文件一致。编辑 docs/catalog.source.json 后，运行 npm run catalog 以重新生成目录文件。请参阅 CONTRIBUTING.md。

docs/ 目录包含目录和客户端指南，examples/ 目录包含对话，scripts/ 目录包含目录生成器。对该仓库所做的更改会通过仓库发布文档；托管连接器的部署由应用仓库负责。

---

许可

文档：CC BY 4.0。