Dapper, em todo lugar

O servidor MCP da Dapper expõe toda a API como ferramentas descobríveis para qualquer agente compatível com MCP. Conecte um cliente e faça login com sua conta Dapper no navegador — sem API key para colar.

Passo a passo por cliente

Guias para os clientes sobre os quais mais nos perguntam, cada um com o que é preciso antes de começar: que tipo de conta, se o plano precisa ser pago e se funciona no navegador ou só no terminal.

Outros clientes e agentes

Configuração para copiar e colar nos demais clientes MCP. Claude, ChatGPT e Gemini CLI têm seu passo a passo acima. O endpoint é o mesmo em todos; o login é feito no navegador.

{
  "mcpServers": {
    "dapper": {
      "url": "https://api.dapperglobal.com/mcp"
    }
  }
}

https://api.dapperglobal.com/mcp

{
  "mcpServers": {
    "dapper": {
      "url": "https://api.dapperglobal.com/mcp"
    }
  }
}

https://api.dapperglobal.com/mcp

{
  "servers": {
    "dapper": {
      "type": "http",
      "url": "https://api.dapperglobal.com/mcp"
    }
  }
}

https://api.dapperglobal.com/mcp

https://api.dapperglobal.com/mcp

Conectar com uma API key (sem navegador)

Para clientes que se conectam a partir de um servidor, um script ou uma plataforma de agentes e não conseguem abrir um navegador. A mesma API key do painel funciona de três formas: use a que o formulário da sua plataforma oferecer. As três identificam a mesma key: o uso fica registrado em nome dela, e revogá-la corta o acesso pelas três.

1. Header X-API-Key

Para clientes cuja configuração MCP aceita headers próprios (Cursor, scripts, CI). É o mesmo header que a API REST usa.

{
  "mcpServers": {
    "dapper": {
      "url": "https://api.dapperglobal.com/mcp",
      "headers": { "X-API-Key": "dpr_live_..." }
    }
  }
}

2. Bearer token

Para plataformas com um único campo de «Bearer token», «API key» ou «Authorization». Cole a key completa; se o campo pede o header inteiro, é este:

Authorization: Bearer dpr_live_...

3. OAuth client credentials

Para plataformas que pedem Client ID, Client Secret e Token URL. A plataforma troca a key por um access token de uma hora e o renova sozinha.

Token URL

https://api.dapperglobal.com/oauth/tokenCopiar

Onde a plataforma troca suas credenciais pelo access token. Não é /mcp/token, que é o do login no navegador.

Client ID

o ID da sua API key

Um UUID. Aparece no painel, abaixo do prefixo de cada key, com um botão para copiá-lo.

Client Secret

dpr_live_...

A API key completa, que é exibida uma única vez ao criá-la ou rotacioná-la.

Grant type

client_credentials

Se a plataforma perguntar. Este grant não tem refresh token: ao vencer, pede-se outro com as mesmas credenciais.

Envio de credenciais

Basic ou no body

As duas formas são aceitas: header Authorization: Basic (client_secret_basic) ou campos do formulário (client_secret_post). Se houver uma caixa de «Basic Auth no header», qualquer um dos dois estados funciona.

Scope

mcp:read

Opcional; mcp:read é sempre concedido. Deixe em branco se a plataforma não exigir.

Se a plataforma só diz «não foi possível conectar», esta requisição mostra o que o servidor responde. Um 401 invalid_client significa que o ID e a key não correspondem, ou que a key está revogada ou vencida.

curl -s https://api.dapperglobal.com/oauth/token \
  -d grant_type=client_credentials \
  -d client_id=<key-id> \
  -d client_secret=dpr_live_...

# -> {"access_token": "dpr_at_...", "token_type": "Bearer",
#     "expires_in": 3600, "scope": "mcp:read"}

Vale para as três formas

• Use uma key sem restrição de países nem domínios. Uma key restrita continua funcionando na REST, mas o MCP a recusa (401, ou unauthorized_client na troca) porque ainda não consegue aplicar essa restrição.
• As chamadas MCP aparecem na aba MCP do painel. Revogar a key corta o acesso na hora; não é preciso esperar nenhum token vencer.
• Rotacionar uma key cria uma key nova com outro ID. Atualize a key na plataforma antes que a anterior vença e, se você usa client credentials, também o Client ID.

O que você pode perguntar

Exemplos do que um agente conectado consegue resolver com os dados da Dapper.