Coordinalo — Service Business Operations

Coordinalo MCP サーバー

MCP を介して、あらゆる AI エージェントを Coordinalo のスケジュール管理プラットフォームに接続します

---

Coordinalo は、予約およびスケジュール管理の SaaS プラットフォームです。このリポジトリは、Model Context Protocol (MCP) を介して AI エージェントを 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	組織の識別子

API キーはcoordinalo.com/settings/apiで取得できます。詳細はdocs/authentication.mdをご覧ください。

ツールの概要

Tool	Description	Key Params
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 キー、組織スラッグ、認証フロー
• ユースケース — 実際のエージェント統合パターン

使用例

• 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 を実装する他のプラットフォームも同じインターフェースを共有するため、エージェントのコードを移植できます

@servicialo/mcp-server npm パッケージがプロトコルを定義しています。Coordinalo は本番環境のインスタンスを https://coordinalo.com/api/mcp で提供しています。

コミュニティとサポート

• 課題 — バグ報告や機能リクエストはGitHub Issuesをご利用ください
• ツールのリクエスト — 新しい MCP ツールを提案するには、ツールリクエストのテンプレートをご利用ください
• ウェブサイト — coordinalo.com
• Servicialo プロトコル — github.com/servicialo/mcp-server

ライセンス

Apache 2.0