Configuração e Teste
Depois que seu script estiver pronto, o próximo passo é conectá-lo ao Claude. Esta etapa só precisa ser realizada uma vez, mesmo que você atualize seu script com novos recursos posteriormente. Para começar, abra o Claude Desktop e acesse a guia Configurações. Existem várias maneiras de chegar lá:
- Clique no menu hambúrguer no canto superior esquerdo e vá para Arquivo > Configurações
- Use o atalho Ctrl + ,
- Ou clique no seu ícone de perfil no canto inferior esquerdo e escolha Configurações
Depois que o painel de Configurações estiver aberto, role até o final da página. Você verá uma seção Aplicativo Desktop com três abas que estão disponíveis apenas na versão desktop: Geral, Extensões e Desenvolvedor. Para configurar a conexão com o servidor MCP, selecione a aba Desenvolvedor. Dentro da aba Desenvolvedor, clique em Editar Configuração. Isso abrirá a pasta onde os arquivos de configuração do Claude estão armazenados e destacará o arquivo claude-desktop-config.json. Dentro dele, você verá algo assim:
claude-desktop-config.json
Este é apenas um arquivo JSON simples. A chave "mcpServers" é onde o Claude procura informações sobre a quais servidores deve se conectar. No momento, está vazia. Para adicionar um servidor, insira um novo par chave-valor dentro das chaves. A chave pode ser qualquer nome desejado e será usada para rotular seu servidor dentro do Claude. Em seguida, adicione um objeto {} que conterá a configuração do seu servidor.
claude-desktop-config.json
Se desejar aprender mais sobre o formato JSON, consulte o artigo Understanding and Working with JSON Data.
Se você abrir o Claude agora, verá um aviso. Isso é normal — significa que o Claude encontrou seu servidor, mas está faltando uma informação obrigatória. Especificamente, o Claude está procurando pela chave "command", que indica como executar o servidor. Para que o Claude execute seu script, forneça o mesmo comando utilizado no terminal. Para scripts Python, normalmente é python.
O último passo é adicionar a chave "args". Trata-se de uma lista de entradas adicionais que o Claude utilizará com o comando — na maioria dos casos, basta o caminho completo para seu script:
file1
Certifique-se de que o caminho e o nome do arquivo estejam corretos, caso contrário, o Claude não conseguirá executar seu script. Se preferir não escrever tudo sozinho, você pode copiar e colar este modelo como um template.
Depois de salvar o arquivo, reabra o Claude e volte para a guia Desenvolvedor. Desta vez, seu servidor deve estar marcado como Em execução. Agora você pode testá-lo solicitando algo como:
O Claude solicitará permissão para usar seu servidor MCP. Você pode clicar em Permitir uma vez para testar com segurança, ou Permitir sempre se for seu próprio servidor e você confiar nele. Se tudo estiver configurado corretamente, o Claude chamará sua ferramenta e retornará o resultado — neste caso, a hora atual.
Obrigado pelo seu feedback!
Pergunte à IA
Pergunte à IA
Pergunte o que quiser ou experimente uma das perguntas sugeridas para iniciar nosso bate-papo
Awesome!
Completion rate improved to 11.11Configuração e Teste
Deslize para mostrar o menu
Depois que seu script estiver pronto, o próximo passo é conectá-lo ao Claude. Esta etapa só precisa ser realizada uma vez, mesmo que você atualize seu script com novos recursos posteriormente. Para começar, abra o Claude Desktop e acesse a guia Configurações. Existem várias maneiras de chegar lá:
- Clique no menu hambúrguer no canto superior esquerdo e vá para Arquivo > Configurações
- Use o atalho Ctrl + ,
- Ou clique no seu ícone de perfil no canto inferior esquerdo e escolha Configurações
Depois que o painel de Configurações estiver aberto, role até o final da página. Você verá uma seção Aplicativo Desktop com três abas que estão disponíveis apenas na versão desktop: Geral, Extensões e Desenvolvedor. Para configurar a conexão com o servidor MCP, selecione a aba Desenvolvedor. Dentro da aba Desenvolvedor, clique em Editar Configuração. Isso abrirá a pasta onde os arquivos de configuração do Claude estão armazenados e destacará o arquivo claude-desktop-config.json. Dentro dele, você verá algo assim:
claude-desktop-config.json
Este é apenas um arquivo JSON simples. A chave "mcpServers" é onde o Claude procura informações sobre a quais servidores deve se conectar. No momento, está vazia. Para adicionar um servidor, insira um novo par chave-valor dentro das chaves. A chave pode ser qualquer nome desejado e será usada para rotular seu servidor dentro do Claude. Em seguida, adicione um objeto {} que conterá a configuração do seu servidor.
claude-desktop-config.json
Se desejar aprender mais sobre o formato JSON, consulte o artigo Understanding and Working with JSON Data.
Se você abrir o Claude agora, verá um aviso. Isso é normal — significa que o Claude encontrou seu servidor, mas está faltando uma informação obrigatória. Especificamente, o Claude está procurando pela chave "command", que indica como executar o servidor. Para que o Claude execute seu script, forneça o mesmo comando utilizado no terminal. Para scripts Python, normalmente é python.
O último passo é adicionar a chave "args". Trata-se de uma lista de entradas adicionais que o Claude utilizará com o comando — na maioria dos casos, basta o caminho completo para seu script:
file1
Certifique-se de que o caminho e o nome do arquivo estejam corretos, caso contrário, o Claude não conseguirá executar seu script. Se preferir não escrever tudo sozinho, você pode copiar e colar este modelo como um template.
Depois de salvar o arquivo, reabra o Claude e volte para a guia Desenvolvedor. Desta vez, seu servidor deve estar marcado como Em execução. Agora você pode testá-lo solicitando algo como:
O Claude solicitará permissão para usar seu servidor MCP. Você pode clicar em Permitir uma vez para testar com segurança, ou Permitir sempre se for seu próprio servidor e você confiar nele. Se tudo estiver configurado corretamente, o Claude chamará sua ferramenta e retornará o resultado — neste caso, a hora atual.
Obrigado pelo seu feedback!
