Pular para o conteúdo

MCP

O servidor MCP permite que clientes de IA leiam e, opcionalmente, gravem conteúdo estruturado em um projeto. Você controla a conexão a partir do Studio.

O MCP usa as próprias chaves de API. Chaves GraphQL não funcionam com o servidor MCP, e chaves MCP não funcionam com GraphQL.

  1. Vá em Configurações → MCP.
  2. Ative Ativado.
  3. Escolha um Ambiente padrão ou deixe sem definir e envie X-Environment a partir do cliente.
  4. Opcionalmente, limite os Modelos. Deixe a lista vazia para expor todos os modelos de conteúdo.
  5. Ative Permitir gravações somente se os clientes devem criar, atualizar ou excluir entradas.
  6. Ative Permitir rascunhos se as ferramentas de leitura devem poder solicitar rascunhos e outros status não publicados.
  7. Clique em Salvar configurações.

Quando o MCP está desativado, todas as solicitações devolvem 403.

As chaves são criadas na página de chaves de API, não na página do MCP.

  1. Vá em Configurações → Chaves de API.
  2. Clique em Criar chave de API.
  3. Escolha MCP - Somente leitura (mcp_) ou MCP - Leitura e gravação (mcpw_).
  4. Copie a chave e guarde-a em um lugar seguro.

Chaves somente leitura podem listar e ler conteúdo. Chaves de leitura e gravação também podem criar, atualizar e excluir entradas, mas somente quando Permitir gravações está ativado. Chaves MCP não podem alterar modelos, componentes, membros da equipe nem a cobrança.

Os clientes se conectam a https://mcp.contismo.com. A página do MCP mostra a URL de conexão, os cabeçalhos obrigatórios e um trecho mcp.json do Cursor.

Envie a chave como token Bearer. Envie X-Environment com o ID de API do ambiente, ou omita para usar o ambiente padrão configurado acima.

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

Para nomes de ferramentas, recursos e um exemplo completo de cliente, consulte a referência do servidor MCP.