Connect Profound CMS to your AI client

Profound CMS fornisce un server MCP remoto che consente ai client AI compatibili di individuare, creare, aggiornare, pubblicare e gestire i contenuti del CMS.

Endpoint MCP:

http://107.21.107.99:8081/mcp

In produzione, utilizza la versione HTTPS dell'URL MCP configurato, quando disponibile.

Autenticazione

Profound CMS MCP utilizza OAuth di WorkOS.

Per connetterti:

1. Crea un account Profound CMS.
2. Verifica che il tuo account appartenga all'organizzazione corretta.
3. Aggiungi il server MCP al tuo client AI.
4. Completa l'accesso tramite browser quando richiesto.

Non è necessario copiare una chiave API nel tuo client AI. Dopo l'accesso, il client riceve un token di accesso a breve durata e lo aggiorna automaticamente.

Il tuo ruolo nel CMS controlla l'accesso:

• I membri possono leggere i contenuti del CMS.
• Gli editor e gli amministratori possono creare, aggiornare e pubblicare contenuti.

Claude Code

Esegui:

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

Quindi avvia Claude Code e completa il flusso di autenticazione tramite browser.

Verifica la connessione:

claude mcp list

Codex CLI

Esegui:

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

Codex richiederà l'autenticazione al primo utilizzo del server.

Puoi verificare la connessione con:

codex mcp list

OpenCode

Aggiungi quanto segue a:

~/.config/opencode/opencode.json

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

Quindi esegui l'autenticazione:

opencode mcp auth profound

Verifica la connessione:

opencode mcp list

Il server dovrebbe apparire come connesso tramite OAuth.

Cursor, Windsurf e altri client MCP

La maggior parte dei client compatibili con MCP supporta la configurazione HTTP remota standard:

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

In Cursor, Windsurf, Claude Desktop o in un altro client MCP:

1. Apri le impostazioni MCP o delle integrazioni.
2. Aggiungi un server MCP HTTP remoto.
3. Usa l'URL MCP di Profound.
4. Abilita l'autenticazione OAuth se il client offre un'opzione OAuth.
5. Completa l'accesso a Profound CMS nel browser.

Il client deve supportare MCP tramite Streamable HTTP e OAuth. I client che supportano solo server locali o chiavi API statiche non possono autenticarsi direttamente con questo server.

Inizia ogni sessione con l'individuazione

Dopo la connessione, chiedi al tuo client AI di individuare le organizzazioni e i siti web a tua disposizione:

Usa esclusivamente il server MCP di Profound.

Per prima cosa chiama list_my_organizations.
Poi chiama list_organizations.
Usa l'ID dell'organizzazione restituito da list_organizations per chiamare list_websites.

Mostra in una tabella i nomi delle organizzazioni, i nomi dei siti web e gli ID dei siti web.

Tutte le operazioni del CMS richiedono un website_id.

Strumenti disponibili

Il server MCP attualmente fornisce 35 strumenti CMS.

Organizzazioni e siti web

• list_my_organizations
• list_organizations
• list_websites

Pagine

• create_page
• update_page
• delete_page
• get_page
• list_pages

Associazioni delle route

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Le associazioni delle route collegano le pagine modello a contenuti specifici o a valori di parametri.

Componenti

• create_component
• update_component
• delete_component
• list_components

I componenti definiscono tipi di contenuto riutilizzabili e i relativi campi.

Blocchi

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

I blocchi sono istanze di contenuto posizionate nelle pagine.

Campi dinamici ed espressioni di Template Builder

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Questi strumenti gestiscono le espressioni dinamiche fx che calcolano i valori dei campi al momento del rendering.

Documenti e varianti

• create_document
• update_document
• delete_document
• get_document
• list_documents

I documenti sono voci di contenuto riutilizzabili, chiamate anche varianti. list_documents restituisce i metadati; usa get_document per recuperare il contenuto completo.

Traduzioni

• list_document_translations
• upsert_document_translation
• delete_document_translation

Le traduzioni devono essere memorizzate come righe relative alle impostazioni locali in un singolo documento, invece di creare un documento separato per ogni lingua.

Flusso di lavoro tipico del CMS

Un flusso completo dei contenuti solitamente è il seguente:

1. Individua le organizzazioni e i siti web.
2. Esamina i componenti, le pagine, i blocchi e i documenti esistenti.
3. Crea o aggiorna i contenuti richiesti.
4. Usa expected_version quando aggiorni blocchi, componenti o documenti.
5. Pubblica blocchi o documenti.
6. Imposta lo stato della pagina su Live.
7. Verifica i contenuti pubblicati.

Una pagina è visibile pubblicamente solo quando è attiva e i suoi contenuti sono stati pubblicati.

Esempi di prompt

Crea una pagina:

Usando Profound CMS, crea una pagina all'indirizzo /pricing per il sito web <website_id>.
Crea i blocchi richiesti, pubblicali e imposta la pagina su Live.

Aggiorna contenuti esistenti:

Trova la homepage del sito web <website_id>.
Leggi i blocchi attuali, aggiorna il titolo principale dell'hero e pubblica la modifica.

Crea contenuti localizzati:

Per il documento <document_id>, aggiungi le traduzioni in francese e tedesco.
Usa il documento esistente e crea righe di traduzione invece di creare documenti duplicati.

Usa contenuti dinamici:

Per il blocco hero della pagina modello, fai in modo che il titolo principale venga recuperato dal documento associato alla route.
Usa un'espressione per il campo del blocco invece di inserire la formula in draft_content.

Flusso di lavoro end-to-end dei contenuti

Profound CMS MCP può essere combinato con altri server MCP per supportare un flusso di lavoro completo:

Ad esempio:

Figma MCP + Profound CMS MCP

può collegare l'esplorazione del design, la creazione dei contenuti, la redazione nel CMS, la localizzazione e la pubblicazione in un unico flusso di lavoro assistito dall'AI.