Servidores MCP (Model Context Protocol) YouDeserve
A YouDeserve fornece suporte nativo ao Model Context Protocol (MCP). Isso permite que seus Agentes de IA corporativos consultem de forma padronizada e simplificada os dados do seu programa de benefícios e engajamento para gerar insights e interagir com o ecossistema.
Configurando o Servidor MCP passo a passo
No painel administrativo, navegue até Configurações > Integrações e acesse a aba Servidores MCP. Lá você encontrará as URLs base exclusivas para o seu ambiente e exemplos de conexão para as ferramentas de IA mais populares do mercado:
1. Cursor, Claude Desktop e VS Code
Para IDEs e aplicativos desktop baseados na Anthropic ou ferramentas compatíveis, você deve adicionar a configuração do nosso servidor no seu arquivo JSON de configuração do MCP (ex: claude_desktop_config.json). O painel fornecerá o template exato que você deve copiar, seguindo o formato abaixo:
{
"mcpServers": {
"youdeserve": {
"url": "https://api.youdeserve.today/mcp"
}
}
}
Ao iniciar o Cursor ou Claude Desktop, a ferramenta fará uma requisição para a nossa plataforma e solicitará as suas credenciais M2M (Client ID e Secret) para autorizar a conexão de forma persistente e segura no seu ambiente local.
2. Claude Code (CLI)
Se você interage com a inteligência artificial diretamente via terminal, copie o comando exibido no painel e execute-o. Ele registrará o servidor automaticamente através de HTTP:
claude mcp add youdeserve \ --transport http \ --url https://api.youdeserve.today/mcp
3. MCP Inspector
Para depurar e testar nossa integração isoladamente, você pode utilizar o MCP Inspector. Nossa plataforma suporta nativamente a ferramenta oficial. Para rodá-la, use o comando:
npx @modelcontextprotocol/inspector
Na interface que se abrirá, defina o Transport como Streamable HTTP, insira a URL do seu servidor YouDeserve e forneça sua API Key/Secret quando solicitado.
4. Integração Server-to-Server (n8n, Zapier)
Para automações avançadas e comunicação entre servidores, a YouDeserve fornece suporte OAuth 2.0 padrão. Na tela do PWA, você encontrará um exemplo completo usando curl do fluxo Client Credentials.
A automação deve fazer um POST para o endpoint /oauth/token informando as credenciais da chave M2M e os escopos que deseja consultar (ex: mcp:recognitions). Em resposta, receberá um Access Token para ser enviado como Bearer no acesso à rota de MCP.
Contextos Mapeados (Segurança e Recursos)
Lembre-se: Para utilizar qualquer ferramenta listada acima, você deve obrigatoriamente criar uma Chave M2M prévia, configurando os escopos desejados.
Isolamento (Tenant-aware): O servidor verifica sua chave e expõe apenas dados da sua própria empresa.
Acesso Somente Leitura: O MCP foca na extração segura de dados (Data Retrieval). Agentes de IA podem buscar e ler informações em profundidade, mas não podem alterar nem deletar registros — o que previne "alucinações" que poderiam corromper sua base de dados.
Sua inteligência artificial poderá consultar ativamente os seguintes contextos (conforme as permissões liberadas na chave M2M):
Reconhecimentos realizados e comportamentos vinculados.
Lista de Recompensas cadastradas e todo o histórico de resgates solicitados.
Situação geral dos Usuários, admissões e saldos / depósitos correntes.
Valores corporativos da empresa (descrições e pilares mapeados).
Histórico de acessos na plataforma e engajamento social (curtidas/destaques).
Nota de Produtividade: O servidor MCP já entrega internamente diversos Prompts Nativos para cada contexto. Eles servem para guiar instantaneamente o seu Agente de IA e extrair os relatórios corretos logo na primeira mensagem de teste!