MCP Server

O Zoop MCP Server fornece assistência especializada sobre o Tap To Pay SDK para Android diretamente no chat da sua IDE.

https://mcp-zoop.ifoodpago.com.br/mcp

Perguntas sobre implementação

Tire dúvidas sobre Tap To Pay SDK no chat da IDE

Documentação técnica

Consulte a documentação automaticamente sem sair do editor

Exemplos de código

Obtenha exemplos específicos para Android

Resolução de dúvidas

Resolva problemas de integração usando tools e prompts

Configuração

1. Abra as configurações

Pressione Cmd/Ctrl + , para abrir as configurações, ou vá em File > Preferences > Settings.

2. Configure o MCP Server

Procure por "MCP" ou "Model Context Protocol" nas configurações e adicione uma nova configuração de servidor MCP.

3. Adicione a configuração JSON

Adicione o seguinte no arquivo de configuração do MCP (~/.cursor/mcp.json ou nas configurações do workspace):

{
  "mcpServers": {
    "zoop-mcp-server": {
      "url": "https://mcp-zoop.ifoodpago.com.br/mcp",
      "transport": "http"
    }
  }
}

4. Reinicie o Cursor

Reinicie o Cursor para aplicar as configurações.

Verificar a Conexão

Após configurar, verifique se o servidor está online fazendo uma pergunta no chat:

@zoop-mcp-server Como posso usar o Tap To Pay SDK no Android?

@zoop-mcp-server Como integrar um dispositivo mPOS com a Zoop?

Ou use a tool quickstart:

Use a tool quickstart

💡
O Copilot deve mostrar o servidor como disponível nas configurações com um indicador de status "Connected" ou "Online".

Tools Disponíveis

As tools são funções chamadas automaticamente no chat quando você menciona algo relacionado ao Tap To Pay SDK ou ao Device POS SDK. Você também pode chamá-las explicitamente.

quickstart

Ferramenta de boas-vindas que fornece uma visão geral das capacidades do servidor.

Use a tool quickstart

Tap To Pay SDK

chat_tap_android

Perguntas sobre integração do Tap To Pay SDK no Android. Tags: android, tap

Todas as tools de Tap To Pay aceitam um parâmetro:

Parâmetro	Tipo	Obrigatório	Descrição
`msg`	`string`	Sim	Sua pergunta sobre a plataforma alvo

Exemplos de perguntas — Tap To Pay

Android:

"Como inicializar o Tap To Pay SDK no Android?" · "Como processar um pagamento com Tap To Pay no Android?" · "Quais são as dependências necessárias para o Tap To Pay Android?" · "Como configurar o Pix no Tap To Pay Android?" · "Como tratar erros de conexão no Tap To Pay Android?"

Prompts Disponíveis

Os prompts são templates pré-configurados que geram instruções para usar as tools corretamente.

generate_tap to pay_prompt

Gera uma instrução para chamar a tool apropriada com base no tópico e plataforma.

Parâmetro	Tipo	Obrigatório	Valores
`topic`	`string`	Sim	`initialization`, `payment`, `pix`, `gateway`, `dependencies`, `basic-integration`
`platform`	`string`	Não	`android` (padrão)

Tópicos disponíveis:

Tópico	Descrição
`initialization`	Inicialização e configuração do SDK
`payment`	Processamento de pagamentos
`pix`	Processamento de pagamentos Pix
`gateway`	Configuração de gateway de pagamento
`dependencies`	Dependências necessárias
`basic-integration`	Integração completa básica

O prompt é usado automaticamente pelo modelo. Por exemplo, ao perguntar:

Preciso de ajuda com inicialização do Tap To Pay SDK no Android

O modelo usa o prompt com topic="initialization" e platform="android", que gera uma instrução para a tool chat_tap_android.

Como Usar

Perguntas simples

Faça uma pergunta no chat e o sistema detecta a plataforma automaticamente:

Como inicializar o Tap To Pay SDK no Android?

O Copilot/Cursor automaticamente detecta que é sobre Android, usa a tool chat_tap_android e retorna a resposta.

Chamada explícita de tools

Chame uma tool diretamente quando quiser garantir qual ferramenta será usada:

Use a tool chat_tap_android with msg="Como inicializar o Tap To Pay SDK? Preciso de um exemplo completo."

Contexto da conversa

O servidor mantém o contexto da conversa automaticamente via session_id. Faça perguntas de acompanhamento na mesma conversa:

Como inicializar o Tap To Pay SDK no Android?

Seguido de:

E como processar um pagamento depois?

O sistema mantém o contexto e fornece respostas relacionadas à conversa anterior.

⚠️
O contexto é mantido apenas na mesma conversa do chat. Ao abrir uma nova conversa, o contexto é perdido.

Referência de tags

Mencione a plataforma ou o tipo de dispositivo na sua pergunta para garantir que a tool correta seja usada:

Tags	Tool
`android`, `tap`	`chat_tap_android`

Exemplos Práticos

Integração inicial do SDK

No chat do Cursor/Copilot:

Preciso integrar o Tap To Pay SDK no meu app Android. Como faço a inicialização completa? Inclua todas as dependências e configurações necessárias.

O que acontece:

O sistema detecta "Android" e "inicialização"
Usa a tool chat_tap_android com sua pergunta
Retorna instruções completas sobre inicialização

Processamento de pagamento

No chat:

Como processar um pagamento com Tap To Pay no Android? Preciso de um exemplo de código completo com tratamento de erros.

O que acontece:

Detecta "Android" e "processar pagamento"
Usa a tool chat_tap_android
Retorna exemplo de código com tratamento de erros

Resolução de problemas

Primeira pergunta:

Estou recebendo o erro "SDK not initialized" ao tentar usar o Tap To Pay no Android. O que pode estar errado?

Pergunta de acompanhamento (na mesma conversa):

Como resolver esse erro? Preciso verificar se estou inicializando corretamente.

O que acontece:

Primeira pergunta usa chat_tap_android e cria uma sessão
Segunda pergunta usa a mesma sessão, mantendo contexto
Resposta considera o erro mencionado anteriormente

Consulta sobre dependências

No chat:

Quais são todas as dependências necessárias para usar Tap To Pay no Android? Inclua versões recomendadas.

O que acontece:

Detecta "Android" e "dependências"
Usa chat_tap_android com pergunta específica
Retorna lista completa de dependências com versões

Dicas de Uso

✅ Boas Práticas

Seja específico sobre a plataforma: mencione "Android" na sua pergunta.

Descreva o contexto: quanto mais detalhes você fornecer, melhor será a resposta.

Faça perguntas de acompanhamento: o sistema mantém contexto na mesma conversa.

Use linguagem natural: não precisa de sintaxe especial — faça perguntas normalmente.

Mencione o que precisa: código, exemplos ou explicações.

Use tags nas perguntas: palavras-chave como "inicialização", "pagamento", "Pix", "erro".

Peça exemplos: "Me mostre um exemplo de código" funciona bem.

❌ Evite

Perguntas genéricas: "Como usar Tap To Pay?" é vago — especifique a plataforma.

Não mencionar a plataforma: sempre indique Android, iOS, Flutter, mPOS, SmartPOS ou Zoop PC.

Assumir que o contexto persiste entre conversas: cada nova conversa começa do zero.

Chamar tools manualmente em código: deixe o sistema fazer isso automaticamente.

Troubleshooting

As tools não estão aparecendo

Verifique se o servidor MCP está configurado corretamente nas configurações da IDE
Confirme que a URL está correta: https://mcp-zoop.ifoodpago.com.br/mcp
Reinicie o Cursor/VS Code/JetBrains
Verifique se há conexão com a internet

A tool errada está sendo usada

Seja mais específico sobre a plataforma na sua pergunta (ex: mencione "Android" explicitamente). Você também pode chamar a tool explicitamente:

Use a tool chat_tap_android with msg="sua pergunta aqui"

Não estou recebendo respostas

Verifique sua conexão com a internet — as tools fazem requisições ao servidor remoto
Tente uma pergunta mais simples primeiro
Verifique os logs do Cursor/Copilot para erros de conexão

O contexto não está sendo mantido

O contexto é mantido apenas na mesma conversa do chat. Ao abrir uma nova conversa, o contexto é perdido. Faça perguntas de acompanhamento na mesma conversa para manter o contexto.

Perguntas Frequentes

Como sei qual tool está sendo usada?

O Copilot/Cursor geralmente mostra qual tool está sendo chamada na interface. Você também pode chamar explicitamente usando Use a tool [nome].

Preciso configurar algo além da URL?

Não. Uma vez configurado o servidor MCP, você pode usar as tools diretamente no chat. O sistema gerencia sessões e contexto automaticamente.

Posso usar as tools para debugar problemas?

Sim. Descreva o problema e a plataforma:

Estou tendo um erro ao processar pagamento no Android: [descrição do erro]

A tool chat_tap_android será usada automaticamente para ajudar a resolver o problema.

Como obter informações sobre Pix?

Mencione "Pix" na sua pergunta:

Como processar pagamento Pix no Android?

O sistema entenderá que você quer informações específicas sobre Pix.

As tools funcionam offline?

Não. As tools fazem requisições para o servidor MCP hospedado em https://mcp-zoop.ifoodpago.com.br/mcp. Você precisa de conexão com a internet.

Posso usar as tools em código?

As tools são chamadas automaticamente pelo modelo quando você faz perguntas no chat. Não é necessário escrever código para chamá-las — faça perguntas em linguagem natural.