Coordinalo — Service Business Operations

Coordinalo MCP 服务

通过 MCP 将任意 AI Agent 接入 Coordinalo 的日程安排平台

---

Coordinalo 是一个预订与日程安排 SaaS 平台。本仓库是通过 模型上下文协议（MCP） 将 AI Agent 接入 Coordinalo 的官方文档和集成指南。

Coordinalo 实现了 Servicialo 开放协议。任何兼容 Servicialo 的 MCP 客户端都可以开箱即用。请参阅 基于 Servicialo 构建。

快速连接

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "coordinalo": {
      "url": "https://coordinalo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-Org-Slug": "your-org-slug"
      }
    }
  }
}

请参阅 examples/claude-desktop.json，获取可直接粘贴的配置。

Cursor IDE

添加到你的 Cursor MCP 设置中：

{
  "mcpServers": {
    "coordinalo": {
      "url": "https://coordinalo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-Org-Slug": "your-org-slug"
      }
    }
  }
}

请参阅 examples/cursor-mcp.json。

任意 MCP 客户端

将你的 MCP 客户端指向：

Endpoint: https://coordinalo.com/api/mcp
Auth:     Authorization: Bearer <YOUR_API_KEY>
Header:   X-Org-Slug: <your-org-slug>

身份验证

每个请求都需要：

标头	值	说明
Authorization	Bearer <API_KEY>	你的 coordinalo.com API 密钥
X-Org-Slug	your-org-slug	你的组织标识符

请在 coordinalo.com/settings/api 获取 API 密钥。完整详情请参阅 docs/authentication.md。

工具摘要

工具	描述	关键参数
availability_get_slots	查询服务提供方／服务的空闲时段	orgSlug、providerId?、serviceId?、dateFrom、dateTo
booking_create	创建新的会话／预约	orgSlug、providerId、serviceId、clientId、scheduledAt
booking_list	按筛选条件列出会话	orgSlug、status?、providerId?、dateFrom?、dateTo?
booking_get	获取单个预约的详细信息	orgSlug、sessionId
booking_reschedule	将预约改到新的时间	orgSlug、sessionId、newScheduledAt、confirm
booking_cancel	取消会话	orgSlug、sessionId、reason、confirm
client_list	列出组织的客户端	orgSlug、search?
client_get	获取客户端详细信息	orgSlug、clientId
client_create	创建新客户端	orgSlug、name、lastName、email?、phone?
admin_list_providers	列出活跃的服务提供方	orgSlug
service_list	列出可预约的服务	orgSlug
report_dashboard	获取组织摘要指标	orgSlug、date?

完整参数文档、响应格式和示例请参阅 docs/tools.md。

文档

• 快速入门 — 连接并在 5 分钟内完成首次预约
• 工具目录 — 所有可用工具的完整参考
• 身份验证 — API 密钥、组织标识和身份验证流程
• 使用案例 — 真实场景中的 Agent 集成模式

示例

• claude-desktop.json — Claude Desktop MCP 配置
• cursor-mcp.json — Cursor IDE MCP 配置
• booking-agent.js — Node.js 自主预约流程
• availability-check.py — Python 可预约时段检查器

基于 Servicialo 构建

Coordinalo 实现了 Servicialo 开放协议——面向服务排期平台的开源 MCP 服务规范。这意味着：

• 任何兼容 Servicialo 的客户端都可以直接使用 Coordinalo，无需修改
• 工具名称和参数遵循 Servicialo 规范
• 实现 Servicialo 的其他平台使用相同的接口，因此你的 Agent 代码具有可移植性

@servicialo/mcp-server npm 包定义了该协议。Coordinalo 在 https://coordinalo.com/api/mcp 提供生产环境实例。

社区与支持

• 问题反馈 — 通过 GitHub Issues 报告错误并提交功能请求
• 工具请求 — 使用工具请求模板提议新增 MCP 工具
• 网站 — coordinalo.com
• Servicialo 协议 — github.com/servicialo/mcp-server

许可证

Apache 2.0