Como adicionar um servidor MCP ao Claude Cowork (configuração de conectores)

Você cola a URL de um servidor no Claude Cowork, clica em Add e nada útil acontece. Ou o conector aparece, mas o Claude nunca chama nenhuma de suas ferramentas. Quase toda configuração que falha se deve a um mesmo erro: escolher o tipo errado de servidor MCP para a forma como o Cowork funciona. Um servidor remoto fica na internet pública e é acessado pelos servidores da Anthropic. Um servidor local fica no seu computador e é iniciado pelo Claude Desktop. Os menus, as regras e as mensagens de erro são diferentes em cada caso.

Este artigo apresenta os dois caminhos usando os nomes de menus da documentação de suporte da Anthropic, um arquivo de configuração que você pode colar, uma lista de verificação de segurança e uma tabela de solução de problemas. A última seção mostra um exemplo prático: conectar o PicassoIA para que o Claude gere imagens e vídeos como parte de uma tarefa no Cowork.

O que um servidor MCP faz no Cowork

MCP, sigla de Model Context Protocol, é o padrão aberto que permite ao Claude chamar ferramentas externas. Um servidor publica uma lista de ferramentas, cada uma com um nome e um esquema, e o Claude decide quando uma tarefa precisa de uma delas. Ler uma linha de banco de dados, enviar uma mensagem no Slack, abrir um chamado ou renderizar uma imagem: cada uma dessas ações é uma chamada de ferramenta.

O Cowork é a parte do Claude Desktop criada para trabalhos de várias etapas no seu próprio computador. De acordo com a visão geral de arquitetura da Anthropic, o código que você pede ao Claude para executar roda dentro de uma máquina virtual isolada, usando o Apple Virtualization.framework no macOS e o Hyper-V no Windows. Esse detalhe importa para o MCP, porque define onde um servidor pode rodar e quem consegue acessá-lo.

Conectores, extensões e arquivos de configuração

A documentação da Anthropic descreve três formas separadas de conectar um servidor, e misturá-las é a principal fonte de confusão.

Conectores personalizados remotos funcionam no Claude, no Cowork e no Claude Desktop, nos planos Free, Pro, Max, Team e Enterprise. Contas Free podem usar um conector personalizado, então escolha o que você mais usa.

Qual caminho combina com a sua configuração

Use o formato do que você recebeu:

• Uma URL que começa com https:// indica um conector personalizado. Não a coloque no arquivo de configuração.
• Um comando como npx some-server indica uma entrada no arquivo de configuração, ou uma extensão, se o autor a disponibilizar.
• Um arquivo que termina em .mcpb indica uma extensão do Desktop. Instale-a pelas Configurações.

💡 Regra prática: se o servidor precisa acessar arquivos ou aplicativos no seu computador, ele precisa rodar localmente. Se ele se conecta a um serviço em nuvem em que você já tem conta, um conector remoto costuma ser o caminho mais fácil.

Antes de adicionar qualquer coisa

Duas verificações economizam a maior parte do tempo perdido: quem tem permissão para adicionar conectores no seu plano e se a Anthropic consegue de fato acessar o seu servidor.

Verificações de plano e permissão

• Free: um conector personalizado no total.
• Pro e Max: você adiciona seus próprios conectores pelas suas configurações.
• Team e Enterprise: apenas Owners e Primary Owners podem adicionar um conector personalizado. Os membros então se conectam a ele individualmente. No Enterprise, uma função personalizada com "Manage access to Libraries" também pode adicioná-los.

Se você é membro de um plano de equipe e não consegue adicionar um conector, esse comportamento é esperado, não é um erro. Peça a um Owner que o adicione e, depois, conecte-se com a sua própria conta.

Acerte a URL do servidor

Esta é a regra que mais atrapalha os desenvolvedores. Em um conector remoto, a conexão "tem origem nos servidores da Anthropic, não na interface de rede da sua máquina." Isso tem três consequências:

1. http://localhost:3000/mcp nunca vai funcionar como conector personalizado, porque os servidores da Anthropic não conseguem enxergar o seu localhost.
2. O servidor precisa ser acessível pela internet pública, a partir dos intervalos de IP da Anthropic.
3. Se o servidor estiver em uma rede privada, você precisa incluir os endereços IP da Anthropic na lista de permitidos do seu firewall.

Se o seu servidor existe apenas no seu notebook, pule para o caminho local. Ele foi feito exatamente para esse caso.

Adicione um servidor remoto passo a passo

Contas Pro e Max

1. Abra Customize e, depois, Connectors.
2. Clique em + Add e, depois, em Add custom connector.
3. Digite um nome e a URL do servidor MCP remoto.
4. Se o fornecedor do servidor deu a você um Client ID e um Client Secret do OAuth, insira-os na seção opcional de OAuth. Caso contrário, deixe-a vazia.
5. Clique em Add.
6. Clique em Connect e entre na sua conta do serviço quando for solicitado.

Owners de Team e Enterprise

Os Owners adicionam o conector uma única vez para toda a organização:

1. Acesse Organization settings e, depois, Connectors.
2. Clique em Add, passe o cursor sobre Custom e escolha Web.
3. Digite o nome do conector e a URL do servidor MCP remoto.
4. Escolha um tipo de autenticação: Sign in now, Sign in when needed ou No sign in.
5. Escolha uma opção de cliente OAuth: Use Claude's published identity (Recommended), Register automatically ou Use your own OAuth client.
6. Adicione cabeçalhos de requisição ou credenciais, se o servidor os exigir.
7. Clique em Add.

Escolha No sign in somente quando o servidor realmente não tiver login. Para OAuth, a identidade publicada recomendada é a opção padrão sensata, a menos que o seu fornecedor oriente a registrar um cliente próprio.

Cada membro então abre Customize, depois Connectors, localiza a entrada marcada como Custom e clica em Connect para se autenticar com a própria conta.

Ative para cada tarefa

Adicionar um conector não significa que toda conversa vai usá-lo. A documentação da Anthropic descreve o botão + no canto inferior esquerdo da caixa de chat, depois Connectors e, por fim, um interruptor por conversa. O Cowork usa a mesma lista de conectores, então abra esse menu dentro da sua tarefa e confirme que o interruptor está ligado antes de digitar o seu pedido.

Em seguida, peça algo que só pode ser respondido pela ferramenta, por exemplo: "Use o conector do Linear para listar minhas issues abertas atribuídas a mim, agrupadas por projeto." Se o Claude responder de memória em vez de chamar a ferramenta, o interruptor está desligado ou o login expirou.

Uma segunda verificação vale os trinta segundos que ela leva. Pergunte ao Claude quais ferramentas o conector oferece e leia a lista. Um servidor só de busca não deve oferecer uma ferramenta de exclusão, e um servidor de anotações não deve oferecer ações de cobrança. Se a lista parecer maior do que a tarefa exige, remova o conector e procure um mais restrito.

Adicione um servidor local ao Cowork

Servidores locais atendem os casos que um conector remoto jamais alcança: arquivos de uma pasta, um banco de dados em localhost, um aplicativo de desktop. Eles rodam na sua máquina e se comunicam com o Claude Desktop por stdio, em vez de pela internet.

Instale uma extensão do Desktop

Um arquivo .mcpb é um pacote zip que contém um servidor local e um manifest.json. Funciona como uma extensão de navegador: alguns cliques e ela está instalada.

1. Abra o Claude Desktop e, depois, Settings, depois Extensions.
2. Navegue pelo diretório ou instale o seu próprio arquivo .mcpb.
3. Siga as instruções de instalação e aprove apenas o que a extensão precisa.

O Claude Desktop inclui o próprio ambiente Node.js, então extensões baseadas em Node não precisam de instalação separada. Uma ressalva: a comparação de conectores de desktop e web da Anthropic lista extensões para o Claude Desktop e o Claude Code, então faça um teste rápido em uma tarefa do Cowork antes de construir um fluxo de trabalho sobre uma delas.

Edite o arquivo de configuração manualmente

Para um servidor stdio iniciado por um comando, o arquivo de configuração é o lugar certo. Seu caminho depende do sistema operacional:

Aqui está uma entrada mínima usando o servidor de sistema de arquivos de referência:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\you\\Documents\\notes"
      ]
    }
  }
}

Copiar prompt

Três detalhes causam a maioria das falhas locais:

• Reinicie o Claude Desktop após cada edição para que ele reconheça a mudança.
• Escape as barras invertidas do Windows como \\ dentro do JSON.
• Instale o Node.js se o comando for npx, já que npx roda a partir do PATH do seu sistema.

Relatos da comunidade afirmam que o Claude Desktop leva os servidores deste arquivo para a máquina virtual do Cowork, onde aparecem como do tipo sdk. A página de arquitetura da Anthropic confirma a outra metade da história: servidores MCP locais rodam no seu dispositivo em sessões locais e não rodam de jeito nenhum em sessões na nuvem. Administradores podem desativá-los pelas configurações isLocalDevMcpEnabled e isDesktopExtensionEnabled, então um notebook de trabalho bloqueado pode impedir os dois.

Mantenha seus conectores seguros

Um conector permite que o Claude atue dentro de outro serviço, não apenas leia dele. O alerta da própria Anthropic é curto e vale seguir: conecte-se apenas a servidores confiáveis, revise as permissões que um conector pede, fique atento a prompt injection e acompanhe mudanças no comportamento das ferramentas. Conectores personalizados podem apontar para serviços que a Anthropic não verificou, então a decisão de confiar cabe a você.

Prompt injection em termos simples: uma página da web, um documento ou um chamado que o Claude lê pode conter frases escritas para parecerem ordens. Um conector com acesso de escrita transforma esse truque de incômodo em algo caro. Limite as ferramentas de escrita a tarefas em que você lê o plano antes de o Claude agir.

Um detalhe de arquitetura é tranquilizador. A Anthropic afirma que os tokens de autorização dos conectores nunca entram no sandbox e que as chamadas dos conectores são feitas do lado do servidor. Código rodando dentro da VM do Cowork não consegue ler os seus tokens.

Soluções para erros comuns de conexão

O servidor nunca aparece

Verifique estes pontos nesta ordem:

• Uma URL remota está no arquivo de configuração. URLs que começam com https:// pertencem a um conector personalizado.
• O arquivo foi editado, mas o Claude Desktop não foi reiniciado.
• O JSON é inválido. Uma vírgula sobrando ou uma barra invertida sem escape quebra o arquivo inteiro.
• Você é membro de um plano de equipe. Um Owner precisa adicionar o conector primeiro.

O login falha ou as ferramentas quebram

💡 Teste rápido: peça ao Claude para listar as ferramentas que um conector oferece. Uma lista vazia significa que o servidor conectou, mas não expôs nada; um erro significa que a própria conexão falhou. Esses dois resultados apontam para soluções diferentes.

Adicione ferramentas de imagem e vídeo com o PicassoIA

Um bom primeiro conector é aquele que produz algo que você consegue ver. O PicassoIA expõe seus modelos via MCP, e a própria referência de API do PicassoIA lista o Claude entre os clientes compatíveis. Os limites que vale conhecer: cada conta tem 5 predições na fila ou em execução ao mesmo tempo, e esse limite é compartilhado entre todas as credenciais de API e todas as conexões MCP. As regras do plano variam conforme o tipo de acesso, então confira na página de preços o que o seu plano inclui antes de enfileirar um lote grande.

As ferramentas do conector são diretas: generate_image, edit_image, generate_video_picassoia, generate_video_seedance, get_generation, list_generations, list_models, get_account e cancel_generation. Os trabalhos são assíncronos. Uma chamada de geração retorna um ID de predição, e o Claude então consulta get_generation até que o status apareça como succeeded ou failed.

Conecte o PicassoIA ao Claude

1. Entre no PicassoIA e abra a página de MCP connections em picassoia.com/en/mcp/accounts.
2. Siga as instruções de conexão dessa página. O endereço do conector fica atrás do seu login, então este artigo não o publica.
3. No Claude, adicione o PicassoIA pelo diretório de Conectores, se a sua conta o listar, ou como conector personalizado, usando o endereço da sua página do PicassoIA.
4. Aprove o login quando o Claude abrir a janela de autorização.
5. Abra uma tarefa do Cowork, ative o conector do PicassoIA e peça ao Claude para executar get_account para confirmar a conexão.

Prompts que funcionam no Cowork

Escolha o modelo conforme a tarefa e depois dê ao Claude um briefing específico.

Três hábitos mantêm os lotes fluindo bem:

• Envie em grupos de cinco ou menos. O limite de simultaneidade vale para a conta inteira.
• Peça ao Claude para resumir as URLs finalizadas em uma nota curta no fim da tarefa, para que nada se perca.
• Rascunhe os prompts primeiro. O Claude pode escrever o briefing, ou você pode testar a redação com um modelo de chat, como o Claude Sonnet 5 no PicassoIA, antes de gastar gerações.

Trate o primeiro resultado como um rascunho. Peça ao Claude que mantenha o assunto e mude uma coisa de cada vez, como o ângulo da câmera, a hora do dia ou o fundo. Pedidos curtos como "mesma cena, ângulo mais baixo" geram resultados comparáveis e deixam claro qual mudança ajudou.

Crie sua primeira imagem no Picasso IA

Agora você tem os dois caminhos: um conector remoto para serviços em nuvem e uma entrada local para ferramentas no seu próprio computador. A forma mais rápida de sentir o ganho é conectar algo visual e observar o Cowork usá-lo. Abra o PicassoIA, gere uma imagem de teste com o PicassoIA Image, depois ative o conector e peça ao Claude três variações dentro de uma tarefa.

Experimente com um assunto, uma iluminação e algumas mudanças de redação. Pequenas edições num prompt produzem resultados surpreendentemente diferentes, e o jeito mais rápido de encontrar o seu estilo é gerar, comparar e ajustar. Sua primeira imagem conectada está a uma tarefa de distância.