Para conectar um servidor MCP ao Claude Code, escolha primeiro o escopo: local para um projeto, usuário para todos os seus projetos ou projeto para compartilhar a configuração. Depois, adicione o servidor e confira a conexão; se uma operação em lote do PhotoCraft falhar, etapas anteriores podem continuar aplicadas.
Escolha o escopo MCP
MCP é o protocolo que conecta o Claude Code a ferramentas e fontes de dados externas. A documentação oficial do Claude Code define três escopos, com diferentes alcances e locais de configuração:
| Escopo | A que se aplica | Local da configuração | Aprovação ou compartilhamento |
| Local | Ao projeto atual, de forma privada para o usuário | ~/.claude.json | Não é compartilhado com a equipe |
| Usuário | A todos os projetos do usuário | ~/.claude.json | Não é compartilhado com a equipe |
| Projeto | Ao projeto atual | .mcp.json na raiz do projeto | Pode ser compartilhado pelo controle de versão; o Claude Code pede aprovação em sessões interativas antes de usar o servidor |
A diferença prática está no alcance: use a configuração local quando o servidor deve ficar restrito àquele projeto e ao seu usuário; escolha a de usuário para reutilizá-lo em seus projetos. A configuração de projeto fica no repositório, mas isso não autoriza automaticamente seu uso: em sessões interativas, é preciso aprovar o servidor. Esses caminhos e condições estão na documentação oficial do Claude Code sobre MCP.
Adicione um servidor e confira a conexão
Para um servidor local que usa o transporte stdio — uma conexão com um processo executado na máquina —, o formato documentado é:
claude mcp add [opções] <nome> -- <comando> [argumentos...]
O separador -- encerra as opções do Claude Code; tudo o que vem depois é passado ao comando do servidor. Troque os itens entre sinais de menor e maior pelo nome, executável e argumentos correspondentes ao servidor que você pretende adicionar.
- Escolha o escopo. Defina se a configuração será local, de usuário ou de projeto; essa escolha determina a quem ela se aplica e onde fica armazenada.
- Adicione o servidor. Execute
claude mcp addcom o nome e o comando do servidor depois de--. As opções e os executáveis variam entre os aplicativos Craft; a publicação de pasqualepillitteri.it relata instruções específicas por aplicativo em seus exemplos. - Confira a configuração. Rode
claude mcp listpara listar servidores ou use/mcpdentro do Claude Code para verificar o estado da conexão. A documentação também descreveclaude mcp geteclaude mcp removepara consultar ou remover uma configuração.
Uma mensagem de sucesso ao adicionar o servidor indica que a configuração foi gravada, mas não confirma, por si só, que houve conexão; essa distinção aparece no relato de pasqualepillitteri.it sobre os servidores Craft.
Confira o resultado, não apenas a conexão
Conectar um servidor permite chamar ferramentas; isso não garante que o arquivo gerado esteja correto. Em tarefas relatadas por pasqualepillitteri.it, um gráfico do DeckCraft se sobrepôs ao título do slide, e uma carta feita no WordCraft inicialmente ocupou duas páginas. São observações de tarefas específicas, não uma classificação geral dos aplicativos. Revise o documento ou a exportação que importa para o seu trabalho antes de usá-los.
Entenda o limite das permissões de arquivos
No PhotoCraft, as raízes de leitura e escrita configuradas delimitam o acesso do servidor aos arquivos. A documentação do projeto também determina que os caminhos permaneçam dentro dessas raízes. Consulte as orientações do PhotoCraft para raízes de arquivos e operações MCP ao configurar esse aplicativo.
Essa restrição vale para o servidor PhotoCraft, não para todas as ferramentas do Claude Code. Em uma tarefa com o FilmCraft, pasqualepillitteri.it relata que o Claude usou uma ferramenta de shell para salvar um quadro quando o servidor do FilmCraft não conseguiu gravá-lo no caminho solicitado. A documentação do Claude Code também recomenda confiar em um servidor antes de conectá-lo.
Recupere uma operação parcial no PhotoCraft
O command_batch do PhotoCraft executa etapas em ordem, mas não funciona como uma transação que desfaz tudo quando uma etapa falha. Se uma etapa posterior der erro, as anteriores que já foram concluídas continuam aplicadas. A documentação do PhotoCraft recomenda inspecionar o estado do documento e o histórico antes de tentar novamente; para experimentar, use uma cópia ou crie um documento novo.
Também separe as alterações no documento dos arquivos exportados: desfazer edições não remove arquivos que já foram gravados no disco. A documentação do PhotoCraft sobre lotes e recuperação explica esse comportamento.
