🚀 Como Conectar com seu Agente de IA

Não é necessário instalar nada manualmente. O comando npx -y papi-mcp baixa e conecta automaticamente em segundos.

1. Claude Desktop

Adicione ao seu arquivo de configuração do Claude Desktop:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "papi": {
      "command": "npx",
      "args": ["-y", "papi-mcp"],
      "env": {
        "PAPI_API_KEY": "sk_live_SEU_TOKEN_AQUI"
      }
    }
  }
}

2. Cursor IDE / Windsurf

No seu projeto, crie ou edite .cursor/mcp.json (ou configure em Settings > Features > MCP):

{
  "mcpServers": {
    "papi": {
      "command": "npx",
      "args": ["-y", "papi-mcp"],
      "env": {
        "PAPI_API_KEY": "sk_live_SEU_TOKEN_AQUI"
      }
    }
  }
}

3. Hermes Agent

No seu arquivo ~/.hermes/config.yaml:

mcp_servers:
  papi:
    command: "npx"
    args:
      - "-y"
      - "papi-mcp"
    env:
      PAPI_API_KEY: "sk_live_SEU_TOKEN_AQUI"

🛠️ Ferramentas Disponíveis (Tools)

| Ferramenta | Descrição | | :--- | :--- | | papi_list_instances | Lista todas as instâncias da conta, status e números conectados. | | papi_get_profile | Retorna dados da conta e perfil do usuário. | | papi_get_instance_status | Verifica o status da conexão em tempo real (CONNECTED, etc.). | | papi_get_qr_code | Retorna o QR Code para conectar instâncias desconectadas. | | papi_send_text | Envia mensagem de texto simples para um número ou grupo. | | papi_send_image | Envia imagens via URL pública com legenda opcional. | | papi_send_audio | Envia áudio ou nota de voz (PTT gravado no microfone). | | papi_send_document | Envia PDFs, planilhas e documentos via URL. | | papi_send_video | Envia vídeos em MP4 via URL. | | papi_send_sticker | Envia figurinhas em formato WEBP. | | papi_send_location | Envia localização geográfica no mapa. | | papi_send_contact | Envia cartão de contato (vCard). | | papi_send_reaction | Envia reações com emoji para mensagens existentes. | | papi_send_buttons | Envia mensagens interativas com botões de resposta rápida. | | papi_send_list | Envia menu de lista interativo com seções e opções. | | papi_send_poll | Cria e envia enquetes / votações interativas. |

🌐 Configuração de Servidor Customizado (Opcional)

Por padrão, o papi-mcp conecta diretamente no endpoint oficial da papi.api.br. Caso utilize uma instância on-premise ou servidor próprio, basta adicionar a variável PAPI_BASE_URL:

"env": {
  "PAPI_API_KEY": "sk_live_...",
  "PAPI_BASE_URL": "https://seu-dominio.com.br/api/v1/mcp"
}

👨💻 Autor e Criador

Desenvolvido por Rafa Martins para a plataforma Papi.

• Site Oficial: https://papi.api.br
• Criador: Rafa Martins ([email protected])
• Painel Papi: papi.api.br

📄 Licença

Distribuído sob a licença MIT. Consulte LICENSE para obter mais informações.