Motley MCP Server

Motley MCP Server とは？

Motley MCP Server は Motley Cloud のホスト型エンドポイント（https://app.motley.ai/api/v1/mcp）です。AI エージェントがガバナンスされたセマンティックレイヤーを通じてデータを照会し、そのモデルやメモリーを管理し、レポートを作成するまでを、すべて会話の中で行えます。

Motley は、AI エージェント向けのオープンソースのセマンティックレイヤー SLayer と、それをホストするマネージドプラットフォーム Motley Cloud を開発しています。エージェントにデータウェアハウスへ生の SQL を書かせる代わりに、メジャー、ディメンション、結合の共通定義と、保存されたビジネス上の文脈（「会計年度は 2 月始まり」「テストアカウントは除外」など）を与えるため、同じ質問には毎回同じ答えが返ります。Motley は Postgres、Snowflake、BigQuery、ClickHouse、Databricks、DuckDB、MySQL などのデータベースに読み取り専用で接続します。この MCP サーバーは、Claude、ChatGPT、Copilot、Cursor にビジネス上の質問へ正しく答えさせたいデータチームやプロダクト開発者に向けたものです。

Motley MCP Server の使い方

仕事用のメールアドレスで app.motley.ai に登録し（または組織の管理者に招待を依頼し）、データソースを接続します。ウェルカム画面からデモデータセットも利用できます。その後、URL で MCP サーバーを追加します。ブラウザのウィンドウが開くので、Motley アカウントにログインして接続を承認します。

Claude Code

claude mcp add --transport http motley https://app.motley.ai/api/v1/mcp

Claude Code 内で /mcp を実行し、ブラウザで Motley のサインインを完了します。Motley のドキュメントには、同等のプロジェクト用 .mcp.json の設定も載っています。

{
  "mcpServers": {
    "motley": {
      "type": "http",
      "url": "https://app.motley.ai/api/v1/mcp"
    }
  }
}

Claude Desktop と claude.ai

Settings を開き、Connectors で「Add custom connector」を選び、名前を Motley にして https://app.motley.ai/api/v1/mcp を貼り付けます。続いて Connect をクリックし、ブラウザで Motley にサインインします。

Cursor

{
  "mcpServers": {
    "motley": {
      "url": "https://app.motley.ai/api/v1/mcp"
    }
  }
}

VS Code

{
  "servers": {
    "motley": {
      "type": "http",
      "url": "https://app.motley.ai/api/v1/mcp"
    }
  }
}

質問を始める前に、サーバーが接続済みと表示されていることを確認してください。

Motley MCP Server の主な機能

• モデル、カラム、メジャー、保存済みメモリーを 1 回の呼び出しでセマンティック検索（search）し、エージェントが照会前に適切な文脈を把握できる。
• run_query による一時的なクエリで、何も保存せずに生の行データを取得。
• チャットからのモデル編集：カラム、メジャー、結合の追加や変更（create_measure、patch_column、create_join などのツール）。変更はそのデータソースへの以降のすべてのクエリに反映される。
• save_memory によるメモリーで、データの癖を次のセッションで再発見する必要がなくなる。
• ドキュメントとレポート：ドキュメントを作成し、テキスト、テーブル、チャート、クエリのブロックを追加。
• 組織メンバーごとの OAuth サインインと、エージェントがセマンティックレイヤーを編集できるか、読み取りと照会のみかを決めるロールベースの権限。
• すべてのツール呼び出しが Motley の Usage ビューに記録され、管理者はセッションの確認やエージェントのフィードバックのレビューができる。

Motley MCP Server のユースケース

• ビジネス上の質問：「店舗別に、平均注文額は前年と比べてどう変化した？」
• レイヤーの探索：「利用できるモデルをすべて挙げて、それぞれが何を扱うか説明して」
• 指標の定義：「月次経常収益は status が 'active' のサブスクリプション金額の合計と定義している。subscriptions モデルにメジャーとして追加して」
• 定義の修正：「revenue メジャーは count ではなく sum を使うべき」
• 文脈の記録：「orders.order_total カラムの単位はドルではなくセント。今後のクエリで合計前に 100 で割るようメモリーを追加して」
• レポート作成：クエリ結果をテーブルやチャート付きの共有可能なドキュメントにする。

Motley MCP Server のトラブルシューティング

• エージェントが照会はできるがモデルを編集できない：権限は Motley のロールに従います。セマンティックレイヤーを編集できるロールを管理者に依頼してください。
• サーバーを追加したが接続されない：接続を承認するブラウザでのログインを完了し、クライアントでサーバーが接続済みになっているか確認してください。
• クエリ結果が想定と違う：なぜその結果になったのかエージェントに説明させ、次のセッションで使えるようメモリーとして記録してください。
• 照会できるデータがまだない：まず Motley アプリでデモデータセットを読み込むか、データソースを追加してください。