Connect Profound CMS to your AI client

Profound CMSは、互換性のあるAIクライアントがCMSコンテンツを検出、作成、更新、公開、管理できるリモートMCPサーバーを提供します。

MCPエンドポイント:

http://107.21.107.99:8081/mcp

本番環境では、利用可能な場合は設定済みのMCP URLのHTTPS版を使用してください。

認証

Profound CMS MCPはWorkOS OAuthを使用します。

接続するには:

1. Profound CMSアカウントを作成します。
2. アカウントが正しい組織に所属していることを確認します。
3. AIクライアントにMCPサーバーを追加します。
4. プロンプトが表示されたら、ブラウザベースのログインを完了します。

AIクライアントにAPIキーをコピーする必要はありません。ログイン後、クライアントは有効期間の短いアクセストークンを受け取り、自動的に更新します。

CMSのロールによってアクセス権が決まります:

• メンバーはCMSコンテンツを読み取れます。
• 編集者と管理者はコンテンツの作成、更新、公開を行えます。

Claude Code

実行:

claude mcp add --transport http Profound http://107.21.107.99:8081/mcp

その後、Claude Codeを起動し、ブラウザ認証フローを完了します。

接続を確認:

claude mcp list

Codex CLI

実行:

codex mcp add Profound --url http://107.21.107.99:8081/mcp

Codexは、サーバーを初めて使用するときに認証を要求します。

次のコマンドで接続を確認できます:

codex mcp list

OpenCode

次の内容を以下のファイルに追加します:

~/.config/opencode/opencode.json

{
  "mcp": {
    "profound": {
      "type": "remote",
      "url": "http://107.21.107.99:8081/mcp",
      "enabled": true,
      "oauth": {}
    }
  }
}

その後、認証します:

opencode mcp auth profound

接続を確認:

opencode mcp list

サーバーがOAuth経由で接続済みとして表示されます。

Cursor、Windsurf、その他のMCPクライアント

ほとんどのMCP互換クライアントは、標準のリモートHTTP設定に対応しています:

{
  "mcpServers": {
    "profound": {
      "url": "http://107.21.107.99:8081/mcp"
    }
  }
}

Cursor、Windsurf、Claude Desktop、またはその他のMCPクライアントで:

1. MCPまたは連携の設定を開きます。
2. リモートHTTP MCPサーバーを追加します。
3. Profound MCP URLを使用します。
4. クライアントにOAuthオプションがある場合は、OAuth認証を有効にします。
5. ブラウザでProfound CMSへのログインを完了します。

クライアントはStreamable HTTP MCPとOAuthに対応している必要があります。ローカルサーバーまたは静的APIキーのみに対応するクライアントは、このサーバーで直接認証できません。

すべてのセッションで最初に検出を実行する

接続後、AIクライアントに、利用可能な組織とウェブサイトを検出するよう依頼します:

Use the Profound MCP server only.

First call list_my_organizations.
Then call list_organizations.
Use the organization ID returned by list_organizations to call list_websites.

Show the organization names, website names, and website IDs in a table.

すべてのCMS操作にはwebsite_idが必要です。

利用可能なツール

MCPサーバーは現在、35個のCMSツールを提供しています。

組織とウェブサイト

• list_my_organizations
• list_organizations
• list_websites

ページ

• create_page
• update_page
• delete_page
• get_page
• list_pages

ルートバインディング

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

ルートバインディングは、テンプレートページを特定のコンテンツまたはパラメータ値に接続します。

コンポーネント

• create_component
• update_component
• delete_component
• list_components

コンポーネントは、再利用可能なコンテンツタイプとそのフィールドを定義します。

ブロック

• create_block
• update_block
• delete_block
• get_block
• list_blocks
• publish_block

ブロックはページ上に配置されるコンテンツのインスタンスです。

動的フィールドとTemplate Builder式

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

これらのツールは、レンダリング時にフィールド値を計算する動的なfx式を管理します。

ドキュメントとバリアント

• create_document
• update_document
• delete_document
• get_document
• list_documents

ドキュメントは、バリアントとも呼ばれる再利用可能なコンテンツエントリです。list_documentsはメタデータを返します。完全なコンテンツを取得するにはget_documentを使用してください。

翻訳

• list_document_translations
• upsert_document_translation
• delete_document_translation

言語ごとに別のドキュメントを作成するのではなく、翻訳は1つのドキュメント内のロケール行として保存してください。

一般的なCMSワークフロー

完全なコンテンツワークフローは通常、次のようになります:

1. 組織とウェブサイトを検出します。
2. 既存のコンポーネント、ページ、ブロック、ドキュメントを確認します。
3. 必要なコンテンツを作成または更新します。
4. ブロック、コンポーネント、ドキュメントを更新するときはexpected_versionを使用します。
5. ブロックまたはドキュメントを公開します。
6. ページの状態をLiveに設定します。
7. 公開されたコンテンツを確認します。

ページは、ライブ状態であり、かつそのコンテンツが公開されている場合にのみ一般公開されます。

プロンプトの例

ページを作成する:

Using Profound CMS, create a page at /pricing for website <website_id>.
Create the required blocks, publish them, and set the page to Live.

既存のコンテンツを更新する:

Find the homepage for website <website_id>.
Read its current blocks, update the hero headline, and publish the change.

ローカライズされたコンテンツを作成する:

For document <document_id>, add French and German translations.
Use the existing document and create translation rows instead of creating duplicate documents.

動的コンテンツを使用する:

For the hero block on the template page, make the headline pull from the route-bound document.
Use a block field expression rather than putting the formula in draft_content.

エンドツーエンドのコンテンツワークフロー

Profound CMS MCPは、他のMCPサーバーと組み合わせることで、完全なワークフローをサポートできます:

例:

Figma MCP + Profound CMS MCP

これにより、デザインの検出、コンテンツ作成、CMSでの編集、ローカライズ、公開を、AI支援による単一のワークフローに統合できます。