Ligar um agente de IA ao Cover

O Cover disponibiliza um servidor MCP para agentes de IA compatíveis. Permite ao proprietário autenticado do restaurante consultar dados analíticos aprovados e, quando autorizado separadamente, gerir custos.

Servidor e início de sessão

Use este URL MCP num cliente compatível:

https://mcp.coveranalytics.app/mcp

O servidor usa MCP sobre Streamable HTTP e OAuth Authorization Code com PKCE S256. O cliente consulta os metadados ativos do servidor para descobrir as definições OAuth e os âmbitos suportados. Inicie sessão no Cover no navegador e aprove apenas o acesso de que o cliente precisa. O acesso fica associado ao restaurante autenticado.

Num cliente MCP que aceite servidores HTTP remotos neste formato, adicione:

{
  "servers": {
    "cover": {
      "type": "http",
      "url": "https://mcp.coveranalytics.app/mcp"
    }
  }
}

Inicie ou recarregue o servidor no cliente. Quando ligar, inicie sessão no Cover e aprove os âmbitos necessários para a tarefa.

Se a sua conta Cover não tiver acesso ao MCP, peça acesso ao Cover. O pedido, por si só, não concede acesso.

Escolher os âmbitos

O cliente deve pedir o conjunto mínimo de âmbitos necessário para a tarefa. mcp:read é o âmbito base das ferramentas analíticas. Os metadados ativos do recurso protegido são a fonte autoritativa: nunca peça um âmbito que não seja anunciado. Os restantes são opcionais quando anunciados:

Âmbito	Acesso
mcp:read	Listar tabelas analíticas aprovadas, consultar as suas definições e obter orientações de consulta. Também é necessário para as ferramentas de escrita com âmbito separado.
mcp:sql:read	Executar SQL aprovado e só de leitura com execute_sql_readonly. Cada consulta tem de ser uma única instrução SELECT ou WITH.
mcp:food-costs:write	Adicionar, corrigir ou apagar estimativas de custo dos Itens do Menu.
mcp:employee-costs:write	Quando anunciado pelo servidor ativo, adicionar, corrigir ou apagar custos horários dos funcionários.

mcp:read não concede acesso SQL nem acesso de escrita. Cada âmbito de escrita é separado. Peça autorização ao proprietário do restaurante antes de solicitar ou usar um âmbito de escrita e obtenha aprovação clara para cada alteração pretendida. O agente deve usar valores e datas fornecidos ou confirmados pelo proprietário; não deve inferir custos alimentares nem salários.

Ferramentas disponíveis

• Análise: list_tables, get_table_info, get_query_guidance.
• SQL: execute_sql_readonly (mcp:sql:read).
• Custos alimentares: find_menu_items, get_food_cost_history, add_food_cost_estimates, correct_food_cost_estimate, delete_food_cost_estimate (mcp:food-costs:write para alterações).
• Custos horários da equipa, quando disponíveis no servidor: find_employees, get_employee_cost_history, add_employee_cost_rates, correct_employee_cost_rate, delete_employee_cost_rate (mcp:employee-costs:write para alterações).

A disponibilidade depende do servidor ligado. Use tools/list para confirmar as ferramentas disponíveis e confirme que os metadados ativos anunciam mcp:employee-costs:write antes de solicitar ou usar acesso de escrita a custos horários. Se o âmbito ou as ferramentas não estiverem disponíveis, considere esta gestão indisponível.

As alterações a custos alimentares permitem simulações, verificações de revisão e novas tentativas idempotentes. Quando disponíveis, as alterações aos custos horários permitem as mesmas salvaguardas. Consulte o histórico antes de corrigir ou apagar e use a revisão atual. As ferramentas de custos horários alteram apenas os custos horários das pessoas; não alteram as definições gerais de custos laborais nem as regras de horas extra.

Descoberta e confiança

Consulte os metadados ativos para confirmar o identificador do recurso e as definições OAuth suportadas:

• Recurso protegido: https://mcp.coveranalytics.app/.well-known/oauth-protected-resource/mcp
• Servidor de autorização: https://mcp.coveranalytics.app/.well-known/oauth-authorization-server

Leia a visão geral de segurança e o aviso de privacidade do Cover antes de ligar. O serviço MCP limita o acesso ao restaurante autenticado e às operações aprovadas. Não permite criar nem editar vendas no POS.