Cursor + Raims
Editor com agente integrado para desenvolver sua integração Raims com contexto do projeto.
Início rápido
Prepare o agente
Instale o Cursor pelo guia oficial e entre na sua conta.
Abra seu projeto
Abra a pasta da aplicação que vai consumir a API Raims e inicie uma conversa no painel Agent. Confirme que a pasta selecionada contém o código do seu backend.
Adicione a documentação
Peça ao agente para ler o índice da documentação Raims e abrir os guias relevantes. O llms-full.txt reúne o conteúdo completo. Comece por autenticação e cobranças.
Experimente um prompt
Leia https://docs.raims.com/llms.txt e os guias de autenticação e cobranças. Analise o backend desta aplicação e proponha um plano para consultar uma cobrança existente em Sandbox com GET /v1/charges/{id}. Prepare um exemplo com a chave em configuração protegida do servidor. Não envie requisições nem use credenciais reais. Apresente as fontes e os arquivos que pretende alterar antes de editar.
Contexto do projeto
Na paleta de comandos, selecione New Cursor Rule, dê o nome raims e escolha Always Apply. O Cursor salva a regra como .cursor/rules/raims.mdc. Use o conteúdo abaixo no corpo da regra; mantenha os metadados criados pelo editor.
# Integração Raims
- Consulte https://docs.raims.com/llms.txt antes de escolher endpoints e campos.
- Use https://docs.raims.com/llms-full.txt para a documentação completa.
- URL base da API: https://api.raims.com.
- Nos exemplos de instalação de produtos Raims, obtenha a versão estável mais
recente pelo gerenciador de pacotes (`latest` quando disponível).
- Prepare exemplos para Sandbox, com autenticação Bearer no backend.
- Mantenha a chave em configuração protegida do servidor. Não coloque segredos
no código, em prompts, logs ou aplicações de navegador.
- Explique o plano e peça autorização antes de enviar requisições à API.Verificar a configuração
Peça ao agente para indicar os guias lidos, a URL base e o ponto do backend em que a chave será carregada. Ele deve preparar o plano e o exemplo sem solicitar uma credencial real no chat.
Ler a documentação não autentica a aplicação. As requisições usam uma chave de API Raims da empresa e do ambiente desejados.
Problemas comuns
Confira se a regra foi salva em .cursor/rules com a extensão .mdc e está
marcada como Always Apply. Abra uma conversa no mesmo projeto.
Abra o guia relevante no navegador e forneça o trecho público como contexto. Peça ao agente para apontar o que falta antes de sugerir código.
Peça ao agente para revisar o guia de autenticação. O backend envia a chave Raims com Bearer; uma credencial do provedor de IA não a substitui.