> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trackup.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar via MCP

> Conecte Claude, ChatGPT, Cursor e outros assistentes ao Trackup e opere sua estrutura conversando.

O **MCP** (Model Context Protocol) é o padrão que permite a um assistente de IA usar ferramentas externas. Com o servidor MCP do Trackup, o assistente lista projetos, cria páginas e links, lê métricas e ajusta campanhas por conta própria, **dentro das permissões que você der**.

Sem código e sem copiar rotas da API: você pede em linguagem natural e o assistente escolhe a ferramenta certa.

Sem códigoOAuth ou chave de APIMesmas permissões da API

```text URL do servidor theme={"dark"}
https://api.trackup.me/mcp
```

> **Deixe seu agente configurar tudo**
>
> Cole este prompt no Claude, ChatGPT, Cursor ou Claude Code. Ele adiciona o servidor MCP do Trackup e te guia na autorização.
>
> ```text theme={"dark"}
> Conecte-se ao servidor MCP do Trackup em https://api.trackup.me/mcp (transporte HTTP). Adicione-o à configuração de MCP do cliente que estou usando e me diga como concluir a autorização.
> ```

***

# Escolha seu assistente

> **[Claude](#claude-ai-e-claude-desktop)**
>
> Claude.ai e Claude Desktop, com OAuth.

> **[ChatGPT](#chatgpt)**
>
> Conector personalizado, com OAuth.

> **[Claude Code](#claude-code)**
>
> Terminal, com OAuth ou chave de API.

> **[Cursor](#cursor)**
>
> Instalação em um clique, com chave de API.

> **[VS Code](#vs-code)**
>
> Instalação em um clique, com chave de API.

> **[Outros clientes](#outros-clientes)**
>
> Qualquer cliente MCP via HTTP.

> [!TIP]
>
> O caminho mais rápido é abrir **Configurações → MCP** no Trackup. A tela já mostra a URL, gera a chave e entrega o comando pronto para o seu cliente.

***

# Dois jeitos de autenticar

| | OAuth | Chave de API |
| :- | :- | :- |
| Como funciona | Você adiciona a URL no assistente e aprova o acesso no Trackup | Você cria uma chave e cola na configuração do cliente |
| Ideal para | Claude.ai, Claude Desktop e ChatGPT, que só aceitam OAuth | Cursor, VS Code, automações e ferramentas de desenvolvimento |
| O que é criado | Uma chave chamada "MCP · nome do cliente", ao aprovar | A chave que você criou |
| Como desconectar | Revogue a chave em **Configurações → Chaves de API** | Revogue a chave em **Configurações → Chaves de API** |

Nos dois casos o assistente age com uma **Chave de API do Time**. Ele só executa o que as permissões e os projetos da chave permitem; o resto volta como erro.

***

# Conectando

## Claude.ai e Claude Desktop

![Claude](https://mintcdn.com/trackup/HRfFKh90WNItz5EJ/icons/claude.svg?fit=max\&auto=format\&n=HRfFKh90WNItz5EJ\&q=85\&s=f7c7eccd09876a879c6a4782992cbe4f)

**1. Abra os conectores**

Vá em **Configurações → Conectores** e clique em **Adicionar**.

**2. Conector personalizado**

Escolha **Adicionar conector personalizado**.

**3. Informe a URL**

Dê um nome (ex.: Trackup), cole `https://api.trackup.me/mcp` e clique em **Continuar**.

**4. Aprove no Trackup**

O Claude abre o Trackup no navegador. Entre na conta, confira o **time**, as **permissões** e os **projetos** e clique em **Autorizar**. Você volta ao Claude já conectado.

## ChatGPT

![ChatGPT](https://mintcdn.com/trackup/HRfFKh90WNItz5EJ/icons/chatgpt.svg?fit=max\&auto=format\&n=HRfFKh90WNItz5EJ\&q=85\&s=2841d39fd3f2452c664f71207d081d5d)

**1. Adicione um conector MCP personalizado**

Nas configurações de conectores do ChatGPT, crie um conector e informe `https://api.trackup.me/mcp`.

**2. Aprove no Trackup**

Entre na conta, confira time, permissões e projetos e clique em **Autorizar**.

> [!NOTE]
>
> Conectores personalizados dependem do plano e do modo de desenvolvedor do ChatGPT. Se a opção não aparecer, verifique a disponibilidade no seu plano.

## Claude Code

**OAuth**

```bash theme={"dark"}
claude mcp add --transport http trackup https://api.trackup.me/mcp
```

Dentro do Claude Code, rode `/mcp` e escolha **Authenticate** para aprovar o acesso no navegador.

**Chave de API**

```bash theme={"dark"}
claude mcp add --transport http trackup https://api.trackup.me/mcp \
  --header "X-Api-Key: YOUR_API_KEY"
```

## Cursor

Em **Configurações → MCP** no Trackup há o botão **Instalar no Cursor**, que já leva a chave. Para configurar manualmente, edite `~/.cursor/mcp.json`:

```json theme={"dark"}
{
  "mcpServers": {
    "trackup": {
      "url": "https://api.trackup.me/mcp",
      "headers": { "X-Api-Key": "YOUR_API_KEY" }
    }
  }
}
```

## VS Code

Em **Configurações → MCP** no Trackup há o botão **Instalar no VS Code**. Para configurar manualmente, edite `.vscode/mcp.json`:

```json theme={"dark"}
{
  "servers": {
    "trackup": {
      "type": "http",
      "url": "https://api.trackup.me/mcp",
      "headers": { "X-Api-Key": "YOUR_API_KEY" }
    }
  }
}
```

## Outros clientes

Qualquer cliente MCP que fale **Streamable HTTP** funciona. Aponte para `https://api.trackup.me/mcp` e envie `X-Api-Key` (ou `Authorization: Bearer`, com um token OAuth). Para testar a chave e listar as ferramentas:

```bash theme={"dark"}
curl -X POST 'https://api.trackup.me/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

***

# O que o assistente consegue fazer

Cada ferramenta MCP corresponde a uma operação da [Referência da API](https://docs.trackup.me/api-reference/projects/list-projects.md), então o assistente tem o mesmo alcance de uma integração por chave.

> **Projetos e analytics**
>
> Listar projetos, ler visão geral, conversões, visitantes e requisições.

> **Páginas e links**
>
> Criar, clonar, duplicar, editar no Builder e publicar páginas; criar links e URLs.

> **Pixels e acionadores**
>
> Criar pixels, acionadores e funis de eventos.

> **Campanhas Meta**
>
> Consultar o Gerenciador de Anúncios, pausar entidades e ajustar orçamentos.

> **Domínios e filtros**
>
> Cadastrar e verificar domínios, criar regras de firewall.

> **Vendas**
>
> Plataformas de venda, conversões, reembolsos e chargebacks.

O assistente nunca acessa cobrança, membros, gestão de chaves, exclusão de projeto, conexões OAuth (Meta, Nuvemshop) nem os endpoints de IA do painel.

***

# Exemplos de pedidos

> **Liste meus projetos no Trackup.**
>
> O assistente chama `listProjects` e pergunta em qual projeto trabalhar.

> **Quantas conversões o projeto Loja teve nesta semana, por fonte de tráfego?**
>
> Lê as conversões e a visão geral do projeto e resume por fonte.

> **Crie um link /oferta-natal apontando para a página Oferta de Natal.**
>
> Localiza a página, cria o link e confirma o endereço final.

> **Clone o site [https://exemplo.com](https://exemplo.com) e publique.**
>
> Inicia o clone, aguarda ficar pronto e publica a página.

***

# Segurança

* **Revise as permissões na aprovação.** Dê só o necessário e restrinja os projetos.
* **Publicar muda o que está no ar.** O assistente pede confirmação antes de republicar uma página editada e antes de publicar o projeto.
* **Tudo fica no histórico.** Cada chamada aparece em **Configurações → Chaves de API → Ver histórico**.
* **Desconectar é revogar a chave.** O acesso termina na hora.

> [!WARNING]
>
> A chave age em nome de quem a criou. Se essa pessoa sair do Time ou perder uma permissão, o assistente perde o acesso junto.

***

**Próximos passos**

→ [Agentes de IA](https://docs.trackup.me/agentes-de-ia.md) · [Casos de uso](https://docs.trackup.me/agentes-de-ia-casos-de-uso.md) · [Referência da API](https://docs.trackup.me/api-reference/projects/list-projects.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.