Connect Profound CMS to your AI client

O Profound CMS fornece um servidor MCP remoto que permite que clientes de IA compatíveis descubram, criem, atualizem, publiquem e gerenciem conteúdo do CMS.

Endpoint MCP:

http://107.21.107.99:8081/mcp

Em produção, use a versão HTTPS do URL MCP configurado sempre que disponível.

Autenticação

O MCP do Profound CMS usa o OAuth do WorkOS.

Para conectar:

1. Crie uma conta no Profound CMS.
2. Confirme que sua conta pertence à organização correta.
3. Adicione o servidor MCP ao seu cliente de IA.
4. Conclua o login pelo navegador quando solicitado.

Você não precisa copiar uma chave de API para o seu cliente de IA. Após o login, o cliente recebe um token de acesso de curta duração e o atualiza automaticamente.

Sua função no CMS controla o acesso:

• Membros podem ler o conteúdo do CMS.
• Editores e administradores podem criar, atualizar e publicar conteúdo.

Claude Code

Execute:

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

Em seguida, inicie o Claude Code e conclua o fluxo de autenticação pelo navegador.

Verifique a conexão:

claude mcp list

Codex CLI

Execute:

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

O Codex solicitará autenticação quando o servidor for usado pela primeira vez.

Você pode verificar a conexão com:

codex mcp list

OpenCode

Adicione o seguinte a:

~/.config/opencode/opencode.json

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

Em seguida, autentique-se:

opencode mcp auth profound

Verifique a conexão:

opencode mcp list

O servidor deve aparecer como conectado por meio do OAuth.

Cursor, Windsurf e outros clientes MCP

A maioria dos clientes compatíveis com MCP oferece suporte à configuração HTTP remota padrão:

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

No Cursor, Windsurf, Claude Desktop ou outro cliente MCP:

1. Abra as configurações de MCP ou integrações.
2. Adicione um servidor MCP HTTP remoto.
3. Use o URL MCP do Profound.
4. Ative a autenticação OAuth se o cliente oferecer essa opção.
5. Conclua o login do Profound CMS no navegador.

O cliente deve oferecer suporte a MCP via HTTP Streamable e OAuth. Clientes que oferecem suporte apenas a servidores locais ou chaves de API estáticas não podem se autenticar diretamente neste servidor.

Comece cada sessão com a descoberta

Após conectar, peça ao seu cliente de IA para descobrir as organizações e os sites disponíveis para você:

Use apenas o servidor MCP do Profound.

Primeiro, chame list_my_organizations.
Depois, chame list_organizations.
Use o ID da organização retornado por list_organizations para chamar list_websites.

Mostre os nomes das organizações, os nomes dos sites e os IDs dos sites em uma tabela.

Todas as operações do CMS exigem um website_id.

Ferramentas disponíveis

O servidor MCP oferece atualmente 35 ferramentas de CMS.

Organizações e sites

• list_my_organizations
• list_organizations
• list_websites

Páginas

• create_page
• update_page
• delete_page
• get_page
• list_pages

Vínculos de rotas

• create_route_binding
• update_route_binding
• delete_route_binding
• get_route_binding
• list_route_bindings

Os vínculos de rotas conectam páginas de modelo a conteúdos específicos ou valores de parâmetros.

Componentes

• create_component
• update_component
• delete_component
• list_components

Os componentes definem tipos de conteúdo reutilizáveis e seus campos.

Blocos

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

Os blocos são instâncias de conteúdo colocadas nas páginas.

Campos dinâmicos e expressões do Template Builder

• set_block_field_expression
• set_block_field_expressions
• list_block_field_expressions
• delete_block_field_expression

Essas ferramentas gerenciam expressões fx dinâmicas que calculam os valores dos campos no momento da renderização.

Documentos e variantes

• create_document
• update_document
• delete_document
• get_document
• list_documents

Documentos são entradas de conteúdo reutilizáveis, também chamadas de variantes. list_documents retorna metadados; use get_document para recuperar o conteúdo completo.

Traduções

• list_document_translations
• upsert_document_translation
• delete_document_translation

As traduções devem ser armazenadas como linhas de localidade em um único documento, em vez de criar um documento separado para cada idioma.

Fluxo de trabalho típico do CMS

Um fluxo de conteúdo completo geralmente se parece com isto:

1. Descubra as organizações e os sites.
2. Inspecione os componentes, páginas, blocos e documentos existentes.
3. Crie ou atualize o conteúdo necessário.
4. Use expected_version ao atualizar blocos, componentes ou documentos.
5. Publique os blocos ou documentos.
6. Defina o estado da página como Live.
7. Verifique o conteúdo publicado.

Uma página fica visível publicamente somente quando está ativa e seu conteúdo foi publicado.

Exemplos de prompts

Criar uma página:

Usando o Profound CMS, crie uma página em /pricing para o site <website_id>.
Crie os blocos necessários, publique-os e defina a página como Live.

Atualizar conteúdo existente:

Encontre a página inicial do site <website_id>.
Leia os blocos atuais, atualize o título principal do hero e publique a alteração.

Criar conteúdo localizado:

Para o documento <document_id>, adicione traduções em francês e alemão.
Use o documento existente e crie linhas de tradução em vez de criar documentos duplicados.

Usar conteúdo dinâmico:

Para o bloco hero na página de modelo, faça com que o título seja obtido do documento vinculado à rota.
Use uma expressão de campo do bloco em vez de inserir a fórmula em draft_content.

Fluxo de conteúdo de ponta a ponta

O MCP do Profound CMS pode ser combinado com outros servidores MCP para oferecer suporte a um fluxo de trabalho completo:

Por exemplo:

Figma MCP + Profound CMS MCP

pode conectar descoberta de design, criação de conteúdo, autoria no CMS, localização e publicação em um único fluxo de trabalho assistido por IA.