seldonframe-mcp

@seldonframe/mcp

Claude Code と Claude Desktop 向けの公式 SeldonFrame MCP サーバーです。

1つのコマンドで、実際のワークスペースを1つ作成します。 初回の実行に API キーは必要ありません。create_workspace({ name: "Dental Clinic Laval" }) を呼び出すと、サーバーは dental-clinic-laval.app.seldonframe.com に、CRM、Cal.diy の予約機能、Formbricks の受付フォーム、Brain v2 が事前にインストールされた実際のホスト型ワークスペースを作成し、ライブ URL を返します。登録画面も、「ゲストモード」も、申請手続きもありません。

60秒で始めるクイックスタート

# 1. From the repo root
cd skills/mcp-server && npm install

# 2. Register with Claude Code — no env vars needed
claude mcp add seldonframe -s user -- node "$(pwd)/src/index.js"

# 3. In Claude Code, just ask:
#    create_workspace({ name: "My Business OS" })

この呼び出しは、次のような結果を返します。

{
  "workspace": { "id": "wsp_…", "slug": "my-business-os", "tier": "free" },
  "urls": {
    "dashboard": "https://my-business-os.app.seldonframe.com",
    "book": "https://my-business-os.app.seldonframe.com/book",
    "intake": "https://my-business-os.app.seldonframe.com/intake"
  },
  "installed": ["crm", "caldiy-booking", "formbricks-intake", "brain-v2"],
  "next": [ "…" ]
}

以降のツール応答にはすべて next: 配列が含まれます。その手順に従ってください。

認証の仕組み

状況	動作
初回の呼び出し	create_workspace は認証なしで POST します。サーバーがワークスペースとベアラートークンを作成します。MCP はトークンを ~/.seldonframe/device.json に保存します。
2回目以降の呼び出し	MCP は Authorization: Bearer <workspace token> を自動的に送信します。
SELDONFRAME_API_KEY が設定されている場合	デバイストークンより優先されます。Pro 機能が利用可能になります。

モードを切り替える必要はありません。最初のワークスペースは永久に無料です。

SELDONFRAME_API_KEY が必要な場合

• 2つ目のワークスペースを追加する場合
• カスタムドメインを接続する場合
• Brain v2 の完全なインテリジェンス機能を利用する場合（ヒューリスティック Brain は常に無料です）
• 公開、エクスポート、組織単位のシークレットローテーションを行う場合

https://app.seldonframe.com/settings/api で取得し、次のように設定します。

export SELDONFRAME_API_KEY=sk-…

MCP サーバーを再起動してください。既存のワークスペースには何も影響しません。

プラグインマニフェストからインストール（ワンショット）

リポジトリのルートに .claude-plugin/plugin.json が含まれています。Claude Code 内で次を実行してください。

/plugin install <path-to-repo>

npm からインストール

claude mcp add seldonframe -- npx -y @seldonframe/mcp

これは、マーケティングサイト、/docs/quickstart ページ、リポジトリの README に掲載されている標準のインストールコマンドです。npx -y を使うため、ユーザーがグローバルにインストールする必要はありません。必要に応じて最新版が取得され、実行されます。

環境変数

• SELDONFRAME_API_KEY (省略可) — Pro 機能（2つ目のワークスペース、カスタムドメイン、Brain v2 の完全版）を有効にします。
• SELDONFRAME_API_BASE (省略可) — API のベース URL を上書きします。デフォルトは https://app.seldonframe.com/api/v1 です。

ツール

ワークスペース： create_workspace、list_workspaces、switch_workspace、clone_workspace、link_workspace_owner、get_workspace_snapshot。 ブロック： install_caldiy_booking、install_formbricks_intake、install_vertical_pack。 カスタマイズ（型付き、バックエンド LLM 不使用）： update_landing_content、customize_intake_form、configure_booking、update_theme。 Soul： fetch_source_for_soul、submit_soul。 運用： list_automations、connect_custom_domain、export_agent、store_secret、list_secrets、rotate_secret。

アーキテクチャ：バックエンドの LLM コストはゼロ

自然言語による推論は、MCP セッション（ユーザー側の Claude Code）で行われます。バックエンドは構造化コマンドのみを受け付け、決定論的に適用します。プロンプトをサーバー側で解析する seldon_it エンドポイントはありません。従来の query_brain は get_workspace_snapshot に置き換えられており、生の状態を返すことで Claude が推論できるようにします。無料プランでは、Seldon の LLM コストは $0 です。推論エンジンにはユーザーの Claude Code サブスクリプションが使われます。

Soul のコンパイル（Seldon のコストはゼロ）

Soul のコンパイルは Seldon のサーバー上ではなく、お使いの Claude Code セッションで実行されます。

1. fetch_source_for_soul({ url }) — 正規化されたテキストを最大 256KB まで返します。
2. エージェントであるあなたが、構造化された Soul オブジェクトを抽出します。
3. submit_soul({ soul }) — ワークスペースに保存します。

トラブルシューティング

Seldon API 401 — SELDONFRAME_API_KEY が無効か、有効期限切れです。https://app.seldonframe.com/settings/api で再生成するか、環境変数を解除してデバイストークンにフォールバックしてください。

Seldon API 402 — API キーなしで Pro 機能を利用しようとしました。SELDONFRAME_API_KEY を設定して再起動してください。

デバイスの状態をリセットするには？ ~/.seldonframe/device.json を削除してください。ホスト型ワークスペースは app.seldonframe.com で引き続き稼働します。削除されるのはローカルトークンのみです。

プライバシーポリシー

ポリシー全文：https://www.seldonframe.com/privacy

• データ収集。 コネクターはローカルで実行され、送信を依頼した内容のみを送信します。構造化されたツールコマンドと業務コンテンツ（ワークスペース名、指定した URL、作成した連絡先情報や予約情報）は、HTTPS 経由で app.seldonframe.com に送信されます。お使いのマシンに保存されるのは、~/.seldonframe/device.json にあるワークスペースのベアラートークンのみです。
• 利用と保存。 送信したデータは、ホスト型の SeldonFrame ワークスペースに保存され、その運用（ウェブサイト、CRM、予約、エージェント）に使用されます。AI モデルのトレーニングには使用されません。
• 第三者との共有。 お客様のデータを販売することはありません。ワークスペース機能は、上記のポリシーに記載されているインフラストラクチャのサブプロセッサー（ホスティング、データベース、お客様が設定した場合のメール／SMS 配信）を利用します。
• 保持期間。 ワークスペースが有効な間はワークスペースデータを保持し、アカウントの削除時または依頼に応じて削除します。ローカルのデバイストークンは、~/.seldonframe/device.json を削除すれば、いつでも削除できます。
• お問い合わせ。 [email protected]

ライセンス

このパッケージ（skills/mcp-server、SeldonFrame MCP コネクター）は MIT ライセンスのもとで提供されています。リポジトリ内のその他の SeldonFrame プラットフォームは引き続き AGPL-3.0 です。リポジトリのルートにある LICENSE をご覧ください。