Dreamlit

Dreamlit MCP

Dreamlit MCP を使うと、AI クライアントから Dreamlit の通知ワークフローの作成、確認、テスト、公開、公開解除、分析、スタイル設定を行えます。

Dreamlit は、Supabase および Postgres アプリ向けのデータベース駆動型通知ワークフロープラットフォームです。成果を重視したプロンプトから通知ワークフローを構築したり、Dreamlit を通じて確認および公開したり、通知のパフォーマンスに関する範囲を限定した分析上の質問に答えたりする際に、この MCP サーバーを使用してください。

サーバー

• 本番環境の MCP URL：https://mcp.dreamlit.ai/mcp
• トランスポート：Streamable HTTP
• 認証：OAuth。OAuth に対応していないクライアント向けに、パーソナルアクセストークンによるフォールバックも利用できます

このリポジトリには、Dreamlit のホスト型リモート MCP サーバーに関する公開セットアップドキュメントと MCP レジストリのメタデータが含まれています。本番バックエンドの実装はオープンソースではありません。

クイックスタート

MCP クライアントのリモートサーバー接続フローを使用し、次の URL を入力してください。

https://mcp.dreamlit.ai/mcp

クライアントで Dreamlit の認証ページが開きます。AI クライアントにアクセスさせるワークスペースを選択し、要求されたスコープを承認してください。

Codex CLI

codex mcp add dreamlit --url https://mcp.dreamlit.ai/mcp
codex mcp login dreamlit

サポートされているすべての v1 スコープを明示的に要求するには、次のようにします。

codex mcp login dreamlit --scopes workflows:read,workflows:write,workflows:publish,analytics:read

MCP Inspector

npx @modelcontextprotocol/inspector

次に Streamable HTTP を選択し、以下を使用してください。

https://mcp.dreamlit.ai/mcp

ツール

Dreamlit が提供するのは、製品レベルのワークフローおよび分析ツールであり、低レベルのグラフ編集やデータベース API ではありません。

ツール	スコープ	目的
get_status	workflows:read	Dreamlit のガイダンス、ワークスペースのコンテキスト、プロジェクトのセットアップ、スキーマのヒント、ワークフローの状態、アプリの URL を取得します。
list_projects	workflows:read	承認済みワークスペースでアクセス可能な Dreamlit プロジェクトを検索します。
list_workflows	workflows:read	名前、説明、トリガーの種類、ページネーションを指定して、プロジェクト内のワークフローを検索します。
list_brand_kits	workflows:read	生成したメールの下書きに適用する前に、保存済みのブランドキット ID とスタイルの概要をページネーション付きで検索します。
get_workflow_and_preview_url	workflows:read	ワークフローの下書きを確認し、編集または公開する前に Dreamlit のプレビュー URL またはビルダー URL を取得します。
get_analytics	analytics:read	フィルターとカーソルページネーションを使用して、範囲を限定した通知分析、受信者のエンゲージメント、ワークフロー実行データを照会します。
create_or_update_workflow	workflows:write	自然言語のプロンプトから、新しいワークフローの下書きを作成するか、既存の下書きを更新します。
send_workflow_test	workflows:write	ワークフローを公開せずに、メールまたは Slack の下書きテストを確認して送信します。
prepare_publish	workflows:publish	公開前にワークフローを検証し、確認に必要なフィールドを返します。
confirm_publish	workflows:publish	ユーザーの明示的な確認後に、ワークフローを公開またはスケジュール設定します。
unpublish_workflow	workflows:publish	ワークフローの稼働中のトリガーまたはスケジュールを無効にします。

推奨フロー

1. まず get_status を呼び出し、ワークスペース、プロジェクトのセットアップ、プロンプトに関するガイダンスを確認します。
2. ユーザーが ID なしでプロジェクトまたはワークフローを指定した場合は、list_projects と list_workflows を使用します。
3. 生成したメールの下書きに特定の保存済みブランドキットを適用する場合は、list_brand_kits を使用します。
4. 既存のワークフローを編集する前に、get_workflow_and_preview_url を使用します。
5. 範囲を限定した分析上の質問には get_analytics を使用します。まずフィルターを指定し、結果が多い場合は返されたカーソルを使ってページネーションします。
6. create_or_update_workflow を使用して、下書きを作成または更新します。
7. 返されたプレビュー URL またはビルダー URL を開き、重要なメールや Slack メッセージのワークフローテストを送信します。
8. ユーザーの明示的な確認を得てから、prepare_publish に続けて confirm_publish を使用し、公開します。

作成しただけの下書きは稼働状態になりません。公開には、必ず別途明示的な手順が必要です。

プロンプトのヒント

ワークフローの構成図ではなく、得たい結果を伝えてください。良いプロンプトには、次の情報が含まれます。

• ワークフローを開始するイベントまたはスケジュール。
• 対象者または受信者。
• メッセージの目的とトーン。
• パーソナライズに必要なデータ。
• タイミング、タイムゾーン、ビジネスルール。
• 受信者が配信を停止できるようにするかどうか。

例：

When a new organization row is inserted, send an internal Slack alert with the organization name, owner email, and plan.

Every Monday at 9 AM America/New_York, send admins a weekly usage digest summarizing active users, failed payments, and new signups.

Tomorrow at 10 AM, announce the launch to active users who opted into product updates. Include unsubscribe.

アクセスモデル

OAuth アクセスの範囲は、認可時に選択したワークスペースに限定されます。個人用アクセストークンはプロジェクト単位であり、Dreamlit のプロジェクト設定から作成できます。

利用可能なスコープ：

• workflows:read
• workflows:write
• workflows:publish
• analytics:read

クライアントに適した最小限の権限を使用してください。ワークフローとブランドキットの読み取り専用クライアントが要求するのは workflows:read のみにし、アナリティクスクライアントが要求するのは analytics:read のみにしてください。

データの取り扱い

Dreamlit MCP は、ワークフローのメタデータ、保存済みブランドキットの概要、接続されたプロジェクトのコンテキスト、および要求された操作の実行に必要な範囲に限定されたアナリティクス結果にアクセスできます。クライアントが MCP 経由でデータベースの認証情報を送信する必要はありません。

アナリティクスへのアクセスは構造化され、ページネーションに対応しています。大規模な結果セットにはフィルターとカーソルを使用してください。CSV エクスポートと一括ダンプは MCP 経由では公開されていません。

シークレット、生の認証情報、またはプライベートトークンをプロンプトに貼り付けないでください。連携と認証情報の管理には、Dreamlit のアプリ設定を使用してください。

サポート

サポートについては、[email protected] までお問い合わせください。