Integração MCP

O Model Context Protocol (MCP) é um padrão aberto para conectar assistentes de IA a ferramentas externas e fontes de dados. A Scavio executa um servidor MCP que dá a qualquer cliente compatível acesso a 11 ferramentas cobrindo Google Search, Amazon, Walmart, YouTube e Reddit. A configuração leva menos de 2 minutos.

Pré-requisitos

1. Obtenha sua chave de API em dashboard.scavio.dev
2. Substitua YOUR_SCAVIO_API_KEY nos exemplos abaixo pela sua chave real

Claude Code

Execute este único comando no seu terminal:

claude mcp add --transport http scavio https://mcp.scavio.dev/mcp \
  --header "x-api-key: YOUR_SCAVIO_API_KEY"

Para adicioná-lo a uma configuração de projeto compartilhada (verificada no controle de versão), use --scope project:

claude mcp add --transport http --scope project scavio https://mcp.scavio.dev/mcp \
  --header "x-api-key: YOUR_SCAVIO_API_KEY"

Alternativamente, adicione a configuração JSON diretamente:

claude mcp add-json scavio '{
  "type": "http",
  "url": "https://mcp.scavio.dev/mcp",
  "headers": {
    "x-api-key": "YOUR_SCAVIO_API_KEY"
  }
}'

Verifique a conexão:

claude mcp list

Claude Desktop

1. Abra o Claude Desktop
2. Vá para Configurações > Desenvolvedor > Editar Configuração
3. Adicione Scavio ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

4. Salve e reinicie o Claude Desktop

Localização do arquivo de configuração:

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

Cursor

1. Abra o Cursor e vá para Configurações > Ferramentas e MCP
2. Clique em + Adicionar Novo Servidor MCP
3. Selecione o tipo HTTP e insira:
   • Nome: scavio
   • URL: https://mcp.scavio.dev/mcp
   • Cabeçalhos: x-api-key: YOUR_SCAVIO_API_KEY
4. Clique em Salvar

Ou edite manualmente .cursor/mcp.json na raiz do seu projeto (ou ~/.cursor/mcp.json para global):

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

Windsurf

1. Abra o Windsurf e clique no ícone de martelo no Cascade
2. Clique em Configurar para abrir a configuração MCP
3. Adicione Scavio a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

4. Salve o arquivo e atualize o Windsurf

VS Code (GitHub Copilot)

1. Crie .vscode/mcp.json na raiz do seu projeto:

{
  "servers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

2. Abra a Paleta de Comandos (Ctrl+Shift+P / Cmd+Shift+P)
3. Execute MCP: Listar Servidores para verificar a conexão

Para configuração global, adicione a mesma configuração às configurações de usuário do VS Code sob mcp.servers.

ChatGPT

O ChatGPT suporta servidores MCP remotos através do recurso Apps e Conectores:

1. Vá para Configurações do ChatGPT > Apps e Conectores
2. Clique em Adicionar conector personalizado
3. Insira a URL do servidor MCP: https://mcp.scavio.dev/mcp
4. Configure a autenticação com sua chave de API
5. Salve e comece a usar as ferramentas Scavio em seus chats

O suporte MCP do ChatGPT requer um plano Plus ou Team e pode exigir configuração OAuth dependendo da sua configuração.

Cline (Extensão VS Code)

1. Abra o VS Code com Cline instalado
2. Clique no ícone de Servidores MCP na barra lateral do Cline
3. Clique em Configurar Servidores MCP
4. Adicione Scavio à configuração:

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

5. Salve e o Cline detectará automaticamente o novo servidor

Zed Editor

1. Abra Configurações (Cmd+,)
2. Navegue para a seção Assistente
3. Adicione Scavio em servidores MCP:

{
  "assistant": {
    "mcp_servers": {
      "scavio": {
        "type": "http",
        "url": "https://mcp.scavio.dev/mcp",
        "headers": {
          "x-api-key": "YOUR_SCAVIO_API_KEY"
        }
      }
    }
  }
}

Qualquer Cliente Compatível com MCP

A Scavio funciona com qualquer ferramenta que suporte o Model Context Protocol. A configuração universal:

{
  "type": "http",
  "url": "https://mcp.scavio.dev/mcp",
  "headers": {
    "x-api-key": "YOUR_SCAVIO_API_KEY"
  }
}

Ferramentas Disponíveis

Uma vez conectado, seu assistente de IA pode usar estas 11 ferramentas:

Solução de Problemas

Servidor não está conectando?

• Verifique se sua chave de API está correta e ativa
• Verifique seus créditos com get_usage ou em dashboard.scavio.dev
• Certifique-se de que a URL é exatamente https://mcp.scavio.dev/mcp (sem barra no final)

Ferramentas não aparecendo?

• Reinicie seu cliente de IA após adicionar a configuração
• Verifique erros de sintaxe JSON no arquivo de configuração
• Confirme se o servidor MCP aparece como "conectado" nas configurações MCP do seu cliente

Próximos Passos

• API de Pesquisa Google -- referência completa de endpoint
• API da Amazon -- pesquisa e detalhes de produtos
• API do YouTube -- pesquisa e metadados
• API do Walmart -- pesquisa de produtos e detalhes
• API do Reddit -- pesquisa de postagens e comentários encadeados
• Limites de Taxa -- limites por plano e cabeçalhos