# Shager no Claude Desktop: entre com um conector personalizado ou use uma chave de API

_2026-08-12 · Adicione o Shager ao Claude Desktop como conector personalizado e entre, sem chave para copiar. Ou use uma chave de API: headers no conector ou mcp-remote na configuração._

O jeito mais simples de ligar o Claude Desktop ao Shager é adicionar https://app.shager.ai/api/mcp como conector personalizado, clicar em Connect, entrar no Shager e aprovar. Não há chave para copiar. Se preferir usar uma chave de API, há mais dois caminhos: um conector personalizado com No sign-in e um header `authorization` com o valor `Bearer shgr_live_...`, se a sua conta mostrar a seção Request headers, ou fazer a ponte com o servidor remoto pelo `claude_desktop_config.json`, usando o pacote open source `mcp-remote`, que encaminha o mesmo header.

Todos os caminhos levam ao mesmo lugar: o Claude no app de desktop consegue listar os espaços de trabalho dos seus clientes, criar rascunhos de posts para várias contas e trazer os cliques por conta. A diferença está em quem guarda a chave e em quanto da configuração cada pessoa da equipe precisa repetir.

## O caminho de um clique: entrar com a sua conta

O servidor MCP do Shager aceita login via OAuth, que é a base dos conectores personalizados do Claude.

1. Abra Customize, depois Connectors, e clique em Add custom connector.
2. Dê o nome `Shager`, informe a URL do servidor MCP `https://app.shager.ai/api/mcp` e clique em Add.
3. Clique em Connect. O Shager abre no navegador: entre, escolha a organização e aprove.

A conexão pode ler e criar rascunhos. Agendar e publicar é uma caixa de seleção separada na tela de aprovação, desmarcada a menos que você a marque. Cada pessoa se conecta com a própria conta, então o registro de auditoria em https://app.shager.ai/dashboard/agents mostra quem fez o quê, e você pode desconectar por lá a qualquer momento.

## Quando usar uma chave de API?

Quando você quer uma chave com escopos exatos, gerenciada por você, ou uma conexão que não depende de login no navegador. A documentação da Anthropic sobre [como adicionar um conector que não está no diretório](https://claude.com/docs/connectors/custom/add-unlisted) é clara sobre esse caso: "Se o servidor usa uma chave de API, escolha No sign-in e adicione a chave em Request headers". A mesma página também diz que a autenticação por request header "está em beta e disponível para um conjunto limitado de organizações". Ou seja, o primeiro caminho é o correto, mas talvez você ainda não tenha acesso a ele. Por isso existe o segundo.

## Caminho 1: conector personalizado com request header

Use este se você enxerga Request headers na janela. Segundo a mesma página, conectores personalizados por URL funcionam nos planos Free, Pro, Max, Team e Enterprise, sendo que o Free fica limitado a um conector personalizado.

No Free, no Pro ou no Max:

1. Abra Customize, depois Connectors, e clique em Add custom connector.
2. Dê o nome `Shager` e informe a URL do servidor MCP, `https://app.shager.ai/api/mcp`.
3. Em Authentication, escolha No sign-in.
4. Abra Request headers, selecione `authorization` na lista e informe o valor `Bearer shgr_live_your_key_here`.
5. Marque o header como Required e clique em Add.

É no passo 4 que a maioria tropeça. A documentação afirma que o Claude "envia o valor exatamente como você digitou. Ele não adiciona esquema de autenticação nem qualquer outro prefixo". Se você colar só a chave, o Shager recebe `Authorization: shgr_live_...` e devolve 401. Inclua a palavra `Bearer` e o espaço.

No Team e no Enterprise, um Owner adiciona o conector em Organization settings, depois Connectors, e os membros se conectam pela própria página Customize. Tome cuidado com esse modelo no Shager. Um request header é uma credencial única, compartilhada por todos da organização, o que, segundo a página da Anthropic, combina com "uma conta de serviço", e não com login individual. Com uma única chave do Shager compartilhada, o registro de auditoria em https://app.shager.ai/dashboard/agents atribui todas as chamadas a essa mesma chave. Se você precisa saber quem fez o quê, peça que cada pessoa se conecte com a própria conta, ou use o Caminho 2 com chaves individuais.

Observe também que não dá para editar os headers depois. Para trocar a chave, remova o conector e adicione de novo.

## Caminho 2: mcp-remote no claude_desktop_config.json

O arquivo de configuração do desktop serve para servidores locais que o Claude Desktop inicia como processos. O artigo de ajuda da Anthropic sobre [conectores personalizados](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) descreve esses servidores locais como "um mecanismo separado" dos conectores remotos, e uma simples entrada `url` ali não é a forma como o Desktop chega a um servidor remoto.

A saída é o [mcp-remote](https://github.com/geelen/mcp-remote), um pacote open source que roda localmente via stdio e encaminha as requisições para um servidor MCP remoto, com headers personalizados. Ele exige o Node.js instalado.

Abra a configuração em Settings, depois Developer, depois Edit Config. O [guia rápido de MCP para servidores locais](https://modelcontextprotocol.io/docs/develop/connect-local-servers) informa os caminhos: `~/Library/Application Support/Claude/claude_desktop_config.json` no macOS e `%APPDATA%\Claude\claude_desktop_config.json` no Windows.

```json
{
  "mcpServers": {
    "shager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.shager.ai/api/mcp",
        "--header",
        "Authorization:${SHAGER_AUTH_HEADER}"
      ],
      "env": {
        "SHAGER_AUTH_HEADER": "Bearer shgr_live_your_key_here"
      }
    }
  }
}
```

O estranho `Authorization:${SHAGER_AUTH_HEADER}`, sem espaço depois dos dois-pontos, é proposital. O README do mcp-remote avisa que o Claude Desktop no Windows (e alguns outros clientes) não escapa espaços dentro de `args`; por isso, o espaço fica na variável de ambiente. Esse formato também funciona no macOS, então use-o em todo lugar e não pense mais nisso.

Se preferir não deixar a chave no JSON de configuração, o mcp-remote também aceita `--header-file`, apontando para um arquivo com um `Name: value` por linha:

```text
Authorization: Bearer shgr_live_your_key_here
```

Feche o Claude Desktop por completo e abra de novo. O guia rápido diz que o app precisa reiniciar para carregar a nova configuração. Depois, abra o menu de conectores a partir do campo de mensagem e confira se o `shager` aparece com as ferramentas dele.

### Se não conectar

Os logs ficam em `~/Library/Logs/Claude` no macOS (`%APPDATA%\Claude\logs` no Windows). O `mcp.log` registra as falhas de conexão, e o `mcp-server-shager.log` guarda a saída do próprio mcp-remote. Um 401 ali significa que o valor do header está errado. Um `command not found` para o npx significa que o Node não está no PATH que o Claude Desktop enxerga, o que é comum quando o Node foi instalado por um gerenciador de versões. Nesse caso, aponte o `command` para o caminho absoluto do `npx`.

## Qual caminho escolher?

| | Conector personalizado com request header | mcp-remote na configuração |
|---|---|---|
| Disponibilidade | Beta, organizações limitadas | Qualquer instalação do Claude Desktop com Node |
| Quem guarda a chave | O Claude, sem mostrá-la de novo | Sua configuração local ou um arquivo de header |
| Funciona no claude.ai pelo navegador | Sim, é um conector da conta | Não, só no desktop |
| Chave por pessoa nos planos Team | Não, um header compartilhado | Sim, cada pessoa configura a sua |
| Trocar a chave | Remover e adicionar o conector de novo | Editar o arquivo e reiniciar |

Para a maioria das pessoas, entrar com a própria conta é o mais limpo de todos. Entre os caminhos com chave, o Caminho 1 é mais limpo para um consultor que trabalha sozinho, se estiver disponível. Para uma agência com cinco pessoas mexendo nas contas dos clientes, o Caminho 2 com chaves individuais mantém o registro de auditoria fiel.

## Um primeiro prompt que prova que funciona

```text
Usando o Shager: quem sou eu, quais espaços de trabalho eu tenho e, no espaço
"Harbor Fitness", liste os canais conectados por rede e por status.
```

Depois, teste um rascunho:

```text
Crie um rascunho de post em "Harbor Fitness" para todos os canais ativos do
Instagram e do Facebook. Legenda: anuncie a nova aula das 6h. Escreva uma
legenda diferente por canal usando a unidade que aparece no nome do canal.
cta_url https://harborfitness.example/6am, campaign "6am-launch". Não agende.
```

Esse segundo prompt usa `create_post` com legendas em `per_channel` e uma `cta_url` rastreável, que dá a cada conta o próprio link curto com `utm_content` definido para aquela conta. O rascunho aparece no Shager, onde uma pessoa ou o link de aprovação do cliente segue a partir dali. Nosso texto sobre [fluxos de aprovação do cliente](/en/blog/client-approval-workflow-for-agencies) explica como as agências costumam montar essa etapa.

## Mantenha a chave com escopo limitado

O chat no desktop é onde as pessoas experimentam, então dê a essa chave apenas `read` e `write`. Sem `publish`, o Shager recusa `schedule_post` e qualquer `create_post` que inclua `schedule_at`, não importa o que for digitado no chat. Para a rotina automatizada que de fato publica, crie uma chave separada com `publish` em https://app.shager.ai/dashboard/agents.

## Perguntas frequentes

### Posso simplesmente colar uma entrada url no claude_desktop_config.json?

Esse arquivo inicia servidores locais como processos, e a Anthropic documenta os servidores remotos como um mecanismo separado, via conectores. Adicione o Shager como conector personalizado e entre com a sua conta, ou use o mcp-remote como o processo local que encaminha para a URL remota com a sua chave.

### Preciso mesmo de uma chave de API?

Não. Adicionar https://app.shager.ai/api/mcp como conector personalizado e entrar com a sua conta é o caminho mais simples, cada pessoa se conecta com a própria conta, e os caminhos com header são opcionais. Use uma chave quando quiser gerenciar os escopos você mesmo.

### A mesma configuração funciona no Claude Code?

O Claude Code aceita autenticação por header de forma nativa com `claude mcp add --transport http` e `--header`, então não precisa de nenhuma dessas soluções. O passo a passo está em [como conectar o Shager ao Claude Code](/en/blog/connect-shager-to-claude-code).

## Próximo passo

Quando o Desktop já conseguir chamar o Shager, o hábito útil é parar de digitar prompts longos e empacotá-los como uma skill. Se você usa a API em vez de um app de chat, comece pelo [guia rápido da API REST](/en/blog/shager-rest-api-quickstart) e pelo [documento OpenAPI](https://app.shager.ai/api/v1/openapi.json), que descrevem exatamente as mesmas operações que o conector expõe.

---
Source: https://shager.ai/pt/blog/connect-shager-to-claude-desktop