Conectando uma IA ao TagServer (MCP)

O TagServer expõe um servidor MCP (Model Context Protocol), o padrão aberto que a maioria dos assistentes de IA modernos suporta. Conecte um cliente compatível uma vez e depois converse com a IA em português pedindo que ela aja na sua conta TagServer. Não é preciso saber programar, e o login é com a mesma conta TagServer que você usa no painel.

O endereço do servidor MCP é sempre:

arduino

https://tgsr.com.br/mcp

O que a IA pode fazer (smart links, estatísticas, pixels, eventos, faturamento, fluxos, regras de tag, dashboards, conectar provedores de anúncios e analytics e mais) está no catálogo de ferramentas.

Antes de começar

Você precisa de duas coisas:

Uma conta TagServer, com o mesmo login que você usa no painel: e-mail e senha, ou "Entrar com Google" se você entra com Google (uma conta criada com Google pode não ter senha).
Um cliente de IA com suporte a MCP. Os dois caminhos documentados usam o Claude:
- Claude Desktop: o aplicativo de desktop (macOS, Windows e Linux em beta). Mais simples, recomendado para começar.
- Claude Code: a ferramenta de linha de comando, para quem usa o terminal.

Outro cliente compatível com MCP funciona de forma equivalente: informe o endereço https://tgsr.com.br/mcp onde o cliente pedir o servidor MCP e siga o fluxo de login dele.

Nota

No plano Free do Claude, o limite é um único conector personalizado. Se você já tem um, libere espaço antes de adicionar o TagServer.

Opção 1: Claude Desktop (recomendado)

Abra o Claude Desktop.
Vá em Customize (Personalizar) -> Connectors (Conectores).
Clique em "+ Add" e depois em Adicionar conector personalizado (Add custom connector).
Dê um nome (por exemplo, TagServer) e cole o endereço https://tgsr.com.br/mcp.
Confirme. O Claude abre uma página de login do TagServer intitulada "Autorizar acesso", com a mensagem de que um assistente de IA quer acessar sua conta TagServer.
Entre com seu e-mail e senha, ou clique em "Entrar com Google" (acima do formulário). Concluir o login já autoriza o acesso; não há um botão "Autorizar" separado depois.
Aparece a tela "Acesso autorizado" e o Claude é levado de volta automaticamente. Se nada acontecer, clique em "Continuar". O conector passa a aparecer como conectado.

Opção 2: Claude Code (terminal)

No terminal, rode:
bash
```
claude mcp add --transport http tagserver https://tgsr.com.br/mcp
```
Por padrão esse comando instala o servidor apenas na pasta atual (escopo local), então ele só aparece quando você abre o Claude Code dentro dela. Para deixá-lo disponível em qualquer pasta da sua máquina, instale no escopo de usuário (system-wide):
bash
```
claude mcp add --scope user --transport http tagserver https://tgsr.com.br/mcp
```
Abra o Claude com claude e rode o comando /mcp.
Selecione tagserver e escolha autenticar. O navegador abre na página de login do TagServer ("Autorizar acesso").
Entre com seu e-mail e senha, ou com "Entrar com Google"; concluir o login autoriza o acesso. A página "Acesso autorizado" confirma e retorna ao fluxo.
De volta ao terminal, o comando /mcp deve mostrar o tagserver como connected.

Se preferir não abrir o menu /mcp, rode claude mcp login tagserver para disparar o fluxo OAuth direto no terminal (disponível a partir da versão 2.1.186 do Claude Code).

Ao conectar, o Claude te leva a uma página do próprio TagServer para entrar com e-mail e senha ou com Google. Sua senha nunca é enviada ao Claude nem à Anthropic: o formulário envia o e-mail e a senha direto para o TagServer, que faz o login no servidor. No login com Google nenhuma senha é enviada; a página manda ao TagServer um código de login de uso único, que o servidor troca pelo token. Em qualquer dos casos, o Claude recebe somente uma autorização para agir na sua conta, na forma de um token, nunca a sua senha.

O TagServer não guarda cópia desse token nem oferece um endpoint de revogação, então ele continua tecnicamente válido até expirar.

Para encerrar o acesso, você remove a credencial guardada no cliente: no Claude Code, use "Clear authentication" no menu do /mcp, rode claude mcp logout tagserver (apaga a credencial e mantém o servidor configurado) ou claude mcp remove tagserver (remove o servidor e também apaga os tokens OAuth guardados); no Claude Desktop, remova o conector em Customize (Personalizar) > Connectors (Conectores). Isso apaga o token guardado no cliente e faz a IA parar de usá-lo. Não é uma revogação no servidor: o token em si permanece válido até chegar ao seu prazo de expiração.

Escolhendo a conta

Com uma única conta, a IA a usa automaticamente. Com mais de uma, a IA pergunta qual usar, ou você pode adiantar dizendo "use a conta X". As ferramentas que agem em uma conta recebem o nome dela.

Agora é só pedir

Alguns exemplos do que você pode escrever:

"Liste os smart links da minha conta e as estatísticas de cliques."
"Crie um link curto apontando para tal endereço."
"Como está a taxa de erros de eventos hoje?"
"Como eu configuro um pixel?" (a IA consulta esta documentação para te responder).

A lista completa do que a IA pode fazer está no catálogo de ferramentas.

Problemas comuns

A página de login não abre: confira se o endereço está exatamente https://tgsr.com.br/mcp. Um endereço errado costuma dar 404 ou falha de conexão, não 401.
Sobre o 401: não trate um 401 como sintoma de endereço errado. O 401 (com o cabeçalho WWW-Authenticate) é a resposta esperada do TagServer antes de você autorizar, e é justamente ele que faz o cliente MCP iniciar o fluxo de login. O próprio Claude Code marca o servidor como "precisa de autenticação" ao receber 401 ou 403.
"E-mail ou senha inválidos. Tente novamente." na tela de autorização: a credencial não foi aceita. Tente entrar de novo com o mesmo e-mail e senha do painel.
"Nenhuma conta TagServer usa este login do Google. Crie uma conta ou entre com e-mail e senha." na tela de autorização: essa conta Google não está ligada a nenhum usuário TagServer. Entre com e-mail e senha, ou antes ligue o Google ao seu usuário no card "Métodos de login" do painel, com o botão "Conectar".
Outras falhas do Google aparecem como "O login com Google foi cancelado." ou "Não foi possível concluir o login com Google. Tente novamente.". Se o login do Google nem abrir, a mensagem é "Não foi possível abrir o login do Google. Tente novamente.".
Tela "Não foi possível concluir" / "Autorização incompleta": faltaram dados de retorno. Não recarregue essa página; reinicie a autorização a partir do assistente de IA (adicione ou conecte de novo).
"Conta não encontrada": peça primeiro "liste minhas contas" e use o nome exato que aparecer.
Quero desconectar: no Claude Desktop, remova o conector em Customize (Personalizar) > Connectors (Conectores); no Claude Code, use "Clear authentication" no menu do /mcp, claude mcp logout tagserver (mantém o servidor configurado) ou claude mcp remove tagserver (remove o servidor). O que isso encerra, e o que não encerra, está em "Sobre o login".

Veja também

Catálogo de ferramentas MCP: a lista completa das ferramentas que a IA pode acionar na sua conta.