# Conectores do Claude: o que são e como adicionar um

[Canonical HTML page](https://gradiently.design/pt-br/guide/claude-connectors)

Um conector dá mãos ao Claude: ele pode buscar nos seus arquivos, ler um projeto ou fazer um design em uma ferramenta real, em vez de descrever como você faria. Veja como funcionam e como adicionar um em poucos minutos.

## The short version

- Os conectores do Claude ligam o Claude a serviços externos para que ele possa buscar, ler e agir neles durante uma conversa.
- Os conectores são construídos sobre o Model Context Protocol, um padrão aberto para conectar assistentes de IA a ferramentas e dados.
- Conectores remotos rodam na web e são adicionados por URL ou por um diretório, enquanto servidores locais rodam no seu próprio computador.
- O Claude pede permissão antes de usar as ferramentas de um conector, e você pode permitir uma ação uma vez ou sempre.
- Os recursos de conector disponíveis dependem do seu plano do Claude e, em organizações, do que o dono habilitou.

Os **conectores do Claude** ligam o Claude a serviços externos para que, durante um chat, ele possa fazer buscas neles, ler dados deles e agir neles, como criar um documento ou um design. Cada conector é um servidor MCP: um pequeno serviço web que fala o Model Context Protocol, um protocolo aberto, e diz ao Claude quais ferramentas oferece. Você adiciona um pelo diretório de conectores do Claude ou, no caso de um conector personalizado, colando a URL do servidor nas configurações do Claude, depois entra no serviço e escolhe o que o Claude pode fazer lá.

## Como os conectores funcionam

Quando um conector está ativado, o Claude recebe a lista das ferramentas dele, cada uma com um nome, uma descrição e as entradas de que precisa. Quando o seu pedido combina com uma delas, o Claude preenche as entradas e pede permissão para executá-la. O serviço faz o trabalho e devolve um resultado, que o Claude lê e usa na resposta. A especificação e uma lista de servidores de exemplo ficam em [modelcontextprotocol.io](https://modelcontextprotocol.io), e [o que é MCP](https://gradiently.design/pt-br/guide/what-is-mcp) explica a ideia em palavras simples.

| Tipo | Onde roda | Como adicionar | Uso típico |
| --- | --- | --- | --- |
| Conector do diretório | Nos servidores do serviço | Escolha na lista do Claude e faça login | Apps populares e armazenamento de arquivos |
| Conector remoto personalizado | Na web, em uma URL | Cole a URL do servidor nas configurações | Qualquer serviço com servidor MCP |
| Servidor local | No seu próprio computador | Uma extensão para desktop ou um arquivo de configuração | Arquivos e apps da sua máquina |
| Servidor no Claude Code | Local ou remoto | `claude mcp add` no terminal | Desenvolvimento e automação |

Quatro formas de o Claude se conectar a ferramentas. Conectores remotos são os mais fáceis de compartilhar e manter atualizados.

## Como adicionar um conector pelo diretório

1. **Abra as configurações de conectores** No Claude na web ou no app para desktop, abra as Configurações e encontre Conectores.
2. **Navegue pelo diretório** Escolha o serviço que você quer. Cada item explica o que o conector pode acessar.
3. **Conecte e faça login** O Claude leva você ao serviço para fazer login e aprovar o acesso, e depois traz você de volta.
4. **Ative em um chat** Em uma conversa, ligue o conector pelo menu de ferramentas. Deixe desligados os que não está usando, para o Claude escolher entre menos ferramentas.

## Como adicionar um conector personalizado

Um conector personalizado é qualquer servidor MCP remoto que não está no diretório, incluindo os de ferramentas menores ou da sua própria empresa. Nas Configurações, em Conectores, escolha adicionar um conector personalizado, dê um nome e cole a URL do servidor. Se o servidor usa login, o Claude guia você. Nos planos Team e Enterprise, talvez o dono precise adicionar ou liberar o conector para a organização antes. A central de ajuda do Claude, da Anthropic, tem os passos atuais para cada plano, e vale conferir, porque os menus mudam.

> **Alguns servidores usam chaves de API** Nem todo servidor faz login pelo navegador. Alguns esperam uma chave de API enviada em um cabeçalho Authorization. Se o formulário de conector do seu app do Claude não tem onde colocá-la, use o Claude Code ou siga o guia de configuração do próprio serviço.

## Adicionar um servidor MCP no Claude Code

O Claude Code adiciona servidores pelo terminal e consegue enviar um cabeçalho personalizado, o que o torna o caminho mais simples para servidores que usam chaves de API. Guarde a chave em uma variável de ambiente para que ela nunca fique no histórico do terminal ou em um arquivo compartilhado.

```bash
# A remote server that signs in through the browser
claude mcp add --transport http example https://example.com/mcp

# A remote server that expects an API key
claude mcp add --transport http gradiently https://gradiently.design/api/mcp \
  --header "Authorization: Bearer $GRADIENTLY_API_KEY"

# Check what is connected
claude mcp list
```

Adicionando servidores remotos ao Claude Code. Troque a URL de exemplo pelo servidor que você quer.

## Um exemplo: o Claude fazendo designs

O design mostra o que um conector muda. Sozinho, o Claude sugere um título e descreve um layout. Conectado ao Gradiently, ele pode buscar Marks, ler a sua marca e criar designs que abrem no Studio, prontos para você conferir e exportar. O dono ou um administrador do workspace cria uma chave de API restrita no Gradiently em Configurações › API e agentes, escolhendo exatamente o que o assistente pode fazer, e a [documentação para desenvolvedores](https://gradiently.design/pt-br/developers/mcp) cobre a configuração. Os designs que o assistente faz assim não gastam créditos do Gradiently.

Um Story vertical do Instagram anunciando horário estendido às sextas, aberto até meia-noite e cozinha até as onze

Um story que o Claude fez a partir de uma frase, por meio de um conector de design: texto real, o Mark da marca, o quadro exato de 1080×1920.

[Criar com o Claude pelo Gradiently](https://gradiently.design/pt-br/guide/design-with-claude) percorre uma conversa completa, de um story a três formatos.

## Como usar conectores com segurança

### Evite

- Conectores personalizados de fontes que você não consegue verificar
- Escolher “sempre permitir” para ações que apagam ou gastam
- Uma chave com todas as permissões, compartilhada em todo lugar
- Deixar todos os conectores ligados em todos os chats

### Faça

- Servidores publicados pelo próprio serviço
- Permita uma vez até confiar no comportamento da ferramenta
- Uma chave restrita por lugar, com o nome dele
- Ative só os conectores de que o chat precisa

Um conector pode ler o que o Claude envia e agir com o acesso que você concedeu. O conteúdo que um conector busca, como uma página web ou um arquivo compartilhado, também pode conter instruções, então leia o que o Claude propõe fazer em seguida em vez de aprovar no piloto automático.

## Resolver problemas com um conector

| Sintoma | Causa provável | Tente |
| --- | --- | --- |
| Conector adicionado, nenhuma ferramenta aparece | Não está ativado neste chat | Ligue pelo menu de ferramentas |
| Erro de não autorizado ou 401 | Chave ou login ausente ou revogado | Reconecte ou crie uma chave nova |
| O Claude ignora o conector | O pedido não combina com nenhuma ferramenta | Cite o serviço e o resultado na sua mensagem |
| Falta a opção de adicionar conectores personalizados | Plano ou configurações da organização | Fale com o dono da organização no Claude ou consulte a central de ajuda |

Quatro problemas comuns ao adicionar um conector.

O ChatGPT tem um sistema parecido, descrito em [apps do ChatGPT](https://gradiently.design/pt-br/guide/chatgpt-apps); [conectar um assistente de IA](https://gradiently.design/pt-br/guide/connect-ai-assistant) mostra o Gradiently em vários clientes, e [servidores MCP para designers](https://gradiently.design/pt-br/guide/mcp-servers-for-designers) sugere quais tipos conectar primeiro.

## FAQ

### O que são os conectores do Claude?

Integrações que permitem ao Claude buscar, ler e agir em serviços externos durante um chat. Cada uma é um servidor MCP que oferece ao Claude um conjunto de ferramentas.

### Como adiciono um conector personalizado ao Claude?

Abra as Configurações, vá em Conectores, escolha adicionar um conector personalizado e cole a URL do servidor MCP remoto, depois faça login se for pedido. Alguns planos exigem que o dono libere antes.

### Qual a diferença entre um servidor MCP local e um remoto?

Um servidor local roda no seu computador e alcança seus arquivos e apps. Um servidor remoto roda na web, em uma URL, então funciona em qualquer dispositivo.

### O Claude consegue fazer designs com um conector?

Sim, com uma ferramenta de design que ofereça um servidor MCP. O Gradiently permite que o Claude crie designs com a sua marca que abrem no Studio para edição.