Tidio

公式

MCPを介してTidioをウェブサイトに接続します。プログラミング環境を離れることなくウィジェットを埋め込めます。

Tidio MCPで何ができますか?

  • Authenticate and connect your Tidio account — run tidio_connect with your site URL to log in via browser and automatically retrieve your public key.
  • Check connection status and get embed code — use tidio_status to confirm you're connected and retrieve the JavaScript snippet for your site.
  • Generate embed code with an existing key — call generate_tidio_embed with your public key to produce the chat widget code, optionally choosing async or sync loading.
  • Disconnect and clear stored credentials — invoke tidio_disconnect to remove saved tokens and public key from local storage.

ドキュメント

Tidio MCP コネクター

AIアシスタントをTidioライブチャットに接続するMCP(モデルコンテキストプロトコル)サーバー - 自動セットアップ付き

機能

  • 自動セットアップ: 1つのコマンドでTidioに接続 - 手動でのキーコピー不要
  • OAuth認証: ブラウザを開いて安全なTidioログインを実行し、公開キーを自動取得
  • 認証情報の永続化: 認証情報は将来のセッションのためにローカルに保存
  • 埋め込みコード生成: 任意のWebサイトですぐに使えるJavaScriptコードを取得

インストール

npm install tidio-mcp-connector

またはクローンしてローカルでビルド:

git clone https://github.com/your-username/tidio-mcp-connector.git cd tidio-mcp-connector npm install npm run build

使用方法

Claude Desktopでの使用

Claude Desktopの設定(~/Library/Application Support/Claude/claude_desktop_config.json)に追加:

{ "mcpServers": { "tidio": { "command": "npx", "args": ["tidio-mcp-connector"] } } }

Lovableでの使用

このMCPコネクターはLovableや類似のAI搭載開発プラットフォームで動作します。カスタムMCPサーバーとして追加してください。

MCP Inspectorでの使用 (テスト)

npx @modelcontextprotocol/inspector npx tidio-mcp-connector

利用可能なツール

tidio_connect (推奨)

Tidioに接続し、自動的に公開キーを取得します。

仕組み:

  1. Tidioのログインページをブラウザで開きます
  2. Tidioアカウントで認証します
  3. 公開キーと埋め込みコードを自動的に返します

パラメーター:

  • site_url (必須): Tidioを埋め込むWebサイトのURL

例:

Connect Tidio to https://mywebsite.com

tidio_status

接続ステータスを確認し、埋め込みコードを取得します。

パラメーター: なし

tidio_disconnect

保存された認証情報をクリアします。

generate_tidio_embed

特定の公開キー(既にお持ちの場合)の埋め込みコードを生成します。

パラメーター:

  • public_key (必須): Tidioの公開キー
  • loading_mode (オプション): "async" (デフォルト) または "sync"

仕組み

  1. ユーザーがtidio_connectを呼び出す(WebサイトのURLを指定)
  2. ブラウザが開く - Tidioの認証ページへ
  3. ユーザーがログイン - Tidioアカウントに
  4. コールバック受信 - MCPサーバーがリフレッシュトークンを取得
  5. API呼び出し実行 - トークンをアクセストークンと交換し、公開キーを取得
  6. 認証情報を保存 - ~/.tidio-mcp/credentials.json
  7. 埋め込みコードを返す - Webサイトに追加可能な状態で

認証情報の保存

認証情報は~/.tidio-mcp/credentials.jsonにローカル保存されます:

{ "public_key": "abc123...", "access_token": "...", "refresh_token": "...", "site_url": "https://example.com", "created_at": "2024-01-01T00:00:00.000Z", "updated_at": "2024-01-01T00:00:00.000Z" }

埋め込みコード出力

コネクターは最適化された非同期読み込みコードを生成します:

開発

依存関係のインストール

npm install

開発モードで実行

npm run dev

本番用にビルド

npm run build

ビルド済みバージョンを実行

npm start

要件

  • Node.js 18以上
  • Tidioアカウント(無料枠で利用可能)

ライセンス

MIT

関連情報

  • Tidio - ライブチャットおよびチャットボットプラットフォーム
  • Model Context Protocol - AI統合のためのオープンスタンダード
  • Lovable - AI搭載アプリ開発