Documentação do servidor MCP

O servidor Biscotti CMP MCP permite que os assistentes de IA interajam com a sua conta Biscotti CMP de forma programática. Faça a gestão de sites, banners, verificações de conformidade, análises de consentimento, documentos legais e muito mais — tudo através de comandos em linguagem natural no seu IDE.

O servidor MCP (Model Context Protocol) funciona como uma ponte entre o seu assistente de IA e a API Biscotti CMP, disponibilizando um conjunto de ferramentas que podem ser chamadas diretamente a partir do seu ambiente de desenvolvimento.

Pré-requisitos

• Node.js 18 ou posterior
• Uma conta Biscotti CMP com um plano Agency ou LTD Agency
• Uma chave API da página «Definições do programador»

Introdução rápida

A forma mais rápida de começar é utilizando npx — sem necessidade de instalação:

npx @biscotti-cmp/mcp-server

Execute o MCP Server diretamente, sem o instalar globalmente. Esta é a abordagem recomendada para a maioria dos utilizadores:

npx @biscotti-cmp/mcp-server

Se preferir instalar o servidor MCP globalmente em seu sistema:

npm install -g @biscotti-cmp/mcp-server

Após a instalação, você pode executar o servidor diretamente:

biscotti-mcp

Para utilizar o servidor Biscotti CMP MCP com o Claude Desktop, adicione a seguinte configuração ao ficheiro de definições do Claude Desktop.

Localização do ficheiro de configuração

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuração

Adicione o seguinte ao seu ficheiro de configuração:

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Reinicie o Claude Desktop após guardar o ficheiro de configuração. As ferramentas Biscotti CMP aparecerão no menu de ferramentas.

Para utilizar o servidor Biscotti CMP MCP com o Cursor, adicione a seguinte configuração às suas definições do Cursor MCP.

Localização do ficheiro de configuração

• Ao nível do projeto: .cursor/mcp.json na raiz do seu projeto
• Global: ~/.cursor/mcp.json

Configuração

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Após guardar, o Cursor irá detetar automaticamente o servidor MCP e disponibilizar as ferramentas no assistente de IA.

Para utilizar o servidor Biscotti CMP MCP com o Kiro, configure-o através das definições do MCP.

Localização do ficheiro de configuração

• Ao nível do projeto: .kiro/settings/mcp.json na raiz do seu projeto
• Global: ~/.kiro/settings/mcp.json

Configuração

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

O Kiro irá detetar automaticamente a configuração do servidor MCP e disponibilizar as ferramentas Biscotti CMP.

O servidor Biscotti CMP MCP é compatível com qualquer cliente compatível com MCP. Utilize a seguinte configuração genérica:

Configuração geral

{
  "mcpServers": {
    "biscotti-cmp": {
      "command": "npx",
      "args": ["-y", "@biscotti-cmp/mcp-server"],
      "env": {
        "BISCOTTI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Se o seu cliente MCP utilizar um formato de configuração diferente, os parâmetros principais são:

• Comando: npx
• Argumentos: -y @biscotti-cmp/mcp-server
• Variável de ambiente: BISCOTTI_API_KEY defina com a sua chave API

Ferramentas para gerenciar seus sites no Biscotti CMP.

Ferramentas para criar e gerir banners de consentimento.

Ferramentas para varredura de sites e verificação do status de conformidade.

Ferramentas para acessar estatísticas de consentimento e dados analíticos.

Ferramentas para a gestão de documentos jurídicos, tais como políticas de privacidade, termos de serviço e páginas de aviso legal.

Ferramentas para gerenciar serviços de terceiros detectados e suas categorias de consentimento.

Ferramentas para gerenciar integrações de webhooks para notificações de eventos em tempo real.

Ferramentas para gerenciamento de contas de agência e operações de clientes.

O servidor Biscotti CMP MCP disponibiliza os seguintes recursos que os assistentes de IA podem consultar para obter contexto:

• biscotti://sites — Lista de todos os sites da sua conta
• biscotti://website/{id} — Configuração detalhada do site
• biscotti://compliance/{id} — Estado atual de conformidade de um site
• biscotti://banners/{websiteId} — Todos os banners de um site

Os recursos fornecem um contexto de leitura apenas que ajuda os assistentes de IA a compreender a sua configuração atual antes de efetuarem alterações.

O MCP Server inclui modelos de prompt integrados para fluxos de trabalho comuns:

Auditoria de Conformidade

Realizar uma auditoria completa de conformidade num site, verificando a presença de cookies, analisando a configuração do consentimento e gerando um relatório.

Execute uma auditoria de conformidade no meu site example.com e sugira melhorias.

Configuração do banner

Crie e configure um banner de consentimento com o seu design preferido e as suas definições de comportamento.

Crie um banner de consentimento compatível com GDPR para meu site com um tema escuro e posição inferior esquerda.

Elaboração de documentos jurídicos

Crie documentos jurídicos com base na configuração do seu site e na jurisdição de destino.

Gere uma política de privacidade para meu site alemão que cubra Google Analytics e Facebook Pixel.

O servidor Biscotti CMP MCP requer uma chave API para se autenticar na API do Biscotti CMP. Todos os pedidos efetuados pelo servidor MCP são autenticados através da sua chave API.

Como funciona a autenticação

1. Pode gerar uma chave API na página «Definições do programador» do seu painel de controlo do Biscotti CMP.
2. A chave API é definida como a BISCOTTI_API_KEY na configuração do seu cliente MCP.
3. O servidor MCP inclui esta chave como um token Bearer em todas as solicitações de API.
4. A API Biscotti CMP valida a chave e devolve dados relativos à sua conta.

Para obter uma chave API para o servidor MCP:

1. Inicie sessão no seu painel de controlo do Biscotti CMP em app.biscotti-cmp.com.
2. Aceda às «Definições do programador» na barra lateral.
3. Clique em «Gerar nova chave» no separador «Chaves API».
4. Dê à sua chave um nome descritivo (por exemplo, «Servidor MCP - Desenvolvimento»).
5. Opcionalmente, defina uma data de validade para a chave.
6. Copie a chave gerada imediatamente — ela só será exibida uma vez.

Melhores práticas de gestão de chaves

• Utilize chaves API distintas para os ambientes de desenvolvimento e de produção.
• Defina datas de validade para as chaves utilizadas temporariamente.
• Alterne as chaves regularmente e revogue as chaves não utilizadas.
• Utilize a funcionalidade de rotação de chaves para substituir as chaves sem tempo de inatividade.