MCP

Servidor MCP (em breve para clientes)

O servidor Model Context Protocol do ProFeedback deixa um agente de IA consultar o NPS, as respostas e os clientes da sua conta.

Autenticação

O servidor usa uma chave de API da conta, na variável PROFEEDBACK_API_KEY, com as mesmas regras da API: pf_test_ lê e grava só no sandbox; chave revogada ou de conta inativa é recusada. Prefira uma chave de escopo leitura para o agente; a ferramenta de escrita exige escopo completo.

Ferramentas

Ferramenta	O que faz
`get_nps_metrics(from_date, to_date, group_by)`	NPS e totais do período (`AAAA-MM-DD`), opcionalmente por atributo ou `source`.
`list_responses(from_date, to_date, category, external_id, limit)`	Notas mais recentes com filtros.
`get_customer(customer_id ou external_id)`	Um cliente e o resumo de NPS dele. E-mail e telefone saem mascarados.
`list_customers(search, limit)`	Busca por nome ou `external_id`.
`create_survey_link(customer_id ou external_id, expires_in_days, source)`	Escrita: gera um link de pesquisa. Exige chave de escopo completo.

Configuração no cliente MCP

Disponível hoje para a equipe da ProCoworking (execução local, transporte stdio, a partir do repositório):

{
  "mcpServers": {
    "profeedback": {
      "command": "python",
      "args": ["mcp_server.py"],
      "cwd": "<repositorio>/backend",
      "env": {
        "DJANGO_SETTINGS_MODULE": "config.settings.prod",
        "PROFEEDBACK_API_KEY": "pf_live_..."
      }
    }
  }
}