Servidor MCP

Use o servidor MCP quando um cliente de IA precisar ler ou editar conteúdo do Contismo. Sites e aplicativos devem continuar usando a API GraphQL.

Ative o servidor e escolha quais modelos, rascunhos e gravações são permitidos em Configurações → MCP. Consulte MCP.

Endpoint

O servidor fala Streamable HTTP. Os clientes se conectam a:

https://mcp.contismo.com

Autenticação

Autentique-se com uma chave de API do MCP. Chaves GraphQL são rejeitadas.

Authorization: Bearer <your-mcp-api-key>
X-Environment: <environment-api-id>

X-Environment é opcional quando um ambiente padrão está salvo no Studio. Se nenhum dos dois estiver definido, a solicitação falha.

Chave	Prefixo	Acesso
MCP - Somente leitura	`mcp_`	Somente ferramentas de leitura
MCP - Leitura e gravação	`mcpw_`	Ferramentas de leitura, mais ferramentas de gravação quando Permitir gravações está ativado

Um servidor desativado retorna 403. As solicitações contam para a cota mensal de chamadas de API do projeto, o mesmo limite do GraphQL.

Ferramentas de leitura

Chame get_content_model primeiro e use o apiId de cada campo nas ferramentas seguintes. Só ficam visíveis os modelos selecionados no Studio. Uma lista de modelos vazia significa todos os modelos de conteúdo.

Ferramenta	O que retorna
`list_content_models`	Modelos que o servidor pode expor
`get_content_model`	Campos e atribuições de taxonomia de um modelo
`list_entries`	Entradas de um modelo, com `limit`, `offset`, `locale`, `status` e filtros
`get_entry`	Uma entrada pelo ID de API do modelo e pelo ID da entrada. Instâncias únicas não precisam de um ID
`list_locales`	Localidades do ambiente atual
`list_taxonomies`	Taxonomias do ambiente atual
`list_taxonomy_terms`	Termos de uma taxonomia
`get_ui_translations`	Textos de tradução da interface de uma localidade

As ferramentas de leitura usam por padrão as entradas publicadas. Um status de DRAFT, IN_REVIEW ou SCHEDULED só é aceito quando Permitir rascunhos está ativado, ou quando a chave pode gravar.

Os campos de recurso de uma entrada incluem metadados e a URL de entrega. O servidor não envia arquivos.

Ferramentas de gravação

As ferramentas de gravação só são registradas para uma chave de leitura e gravação quando Permitir gravações está ativado. Elas não alteram modelos, componentes nem campos.

Ferramenta	O que faz
`create_entry`	Cria uma entrada. As chaves de `input` são os IDs de API dos campos
`update_entry`	Atualiza uma entrada, inclusive o status e o agendamento
`delete_entry`	Exclui uma entrada pelo ID de API do modelo e pelo ID da entrada

Os valores de status coincidem com o GraphQL: DRAFT, IN_REVIEW, PUBLISHED e SCHEDULED. create_entry e update_entry também aceitam scheduledPublishAt e scheduledUnpublishAt como strings de data e hora ISO, além de locale e as atribuições de taxonomia.

Recursos

Os recursos espelham as ferramentas de leitura para clientes que preferem URIs:

contismo://models
contismo://model/{apiId}
contismo://entry/{modelApiId}/{id}

Conectar o Cursor

Copie o trecho em Configurações → MCP, ou use este formato. Substitua a chave e o ambiente.

{
  "mcpServers": {
    "contismo": {
      "url": "https://mcp.contismo.com",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY",
        "X-Environment": "master"
      }
    }
  }
}