Claude Code é a ferramenta de linha de comando do Claude. Para adicionar o conector, basta executar um único comando.
Como conectar no Claude Code?
1. No terminal, execute o seguinte comando:
claude mcp add --transport http HTA_MCP
https://mcp.hilltopads.com/mcp
O Claude Code exibirá a seguinte mensagem de confirmação:
Added HTTP MCP server HTA_MCP
Neste exemplo, HTA_MCP é apenas o nome local do servidor. Você pode escolher outro nome, se preferir.
Etapa 1 — Adicione o servidor com um único comando.
2. Inicie o Claude Code. Ele detectará que o servidor precisa de autenticação. Em seguida, execute o comando: /mcp
Etapa 2 — Execute o comando /mcp.
3. Na lista de servidores, HTA_MCP aparecerá com o status Needs authentication. Abra-o.
Etapa 3 — HTA_MCP precisa de autenticação.
4. Selecione Authenticate.
Etapa 4 — Selecione Authenticate.
5. O Claude Code abrirá uma janela do navegador para realizar a autenticação. (Se ela não abrir automaticamente, copie a URL exibida no terminal e abra-a manualmente no navegador.)
Etapa 5 — Uma janela do navegador é aberta para autenticação.
6. Na página HilltopAds MCP Authorization, cole sua chave de API e clique em Authorize.
Etapa 6 — Autorize usando sua chave de API.
7. O navegador exibirá a mensagem Authentication successful. Feche a aba e retorne ao terminal.
Etapa 7 — Autenticação concluída com sucesso; retorne ao terminal.
8. Execute novamente o comando /mcp. Agora HTA_MCP aparecerá como Connected, com todas as ferramentas disponíveis.
Etapa 8 — HTA_MCP está conectado e suas ferramentas estão disponíveis.
Como usar no Claude Code
Basta solicitar os dados em linguagem natural, e o Claude Code chamará automaticamente o conector. Ele também pode ir além, por exemplo, gerando um gráfico a partir dos dados obtidos.
Experimente a seguinte solicitação:
"using HTA_MCP get advertiser stats for last 7 days and plot a graph for the top-5 geo, grouping by geo."
O Claude Code obtém as estatísticas e gera uma visualização.
Resultado: uma tabela com os 5 principais GEOs e um gráfico gerado automaticamente.