Skip to main content
Craft suporta MCP (Model Context Protocol), que permite conectar com segurança seus documentos do Craft a ferramentas externas. Isso possibilita que aplicativos compatíveis - incluindo Assistentes de IA e ferramentas para desenvolvedores - leiam e trabalhem com o conteúdo que você escolher compartilhar.

​
O que é MCP?

MCP (Model Context Protocol) é um padrão que permite que aplicações externas se conectem a uma fonte específica de informação. No Craft, o MCP dá a essas ferramentas acesso controlado ao conteúdo que você seleciona, para que possam ler, processar e trabalhar com ele de forma segura. Com o MCP ativado, ferramentas externas podem:
  • Ler o conteúdo dos seus Documentos do Craft
  • Gerar resumos, insights ou transformações
  • Ajudar você a escrever ou reestruturar conteúdo
  • Usar seus Documentos como uma fonte de conhecimento atualizada
  • Pesquisar entre os Documentos que você selecionar
Isso elimina a necessidade de exportações manuais ou de copiar e colar.

​
Como o MCP funciona no Craft

Crie uma Conexão MCP a partir da aba Conexões na sidebar para compartilhar as partes certas do seu espaço de trabalho com ferramentas externas. Você pode escolher entre:
  • Criar uma Conexão MCP que inclua todas as suas Notas Diárias, ou
  • Configurar uma conexão personalizada onde você escolhe Documentos específicos (um ou mais) para incluir
Cada conexão permite definir permissões de acesso e visibilidade, para que você mantenha controle sobre o que é compartilhado. Uma vez criada, o Craft gera automaticamente um endpoint MCP único para essa conexão. Você pode então adicionar esse endpoint a qualquer ferramenta compatível com MCP para conectá-la de forma segura aos Documentos escolhidos - mantendo todo o resto do seu espaço de trabalho privado.
A aba Conexões na sidebar, com as seções de conexões MCP e API
O servidor MCP do Craft agora suporta acesso completo ao nível do Espaço com recursos avançados:
  • Pesquisar em todos os Documentos com filtragem por Pastas, Tags e data
  • Notas Diárias e Tarefas totalmente acessíveis via MCP
  • Criar, atualizar e excluir Documentos programaticamente
  • Gerenciamento de Coleções, incluindo criação e edição de esquemas
  • Busca avançada com suporte a regex e filtros de data sensíveis ao fuso horário
  • Organização por Pastas com suporte recursivo a subpastas
Consulte a documentação oficial do MCP para detalhes completos.
Depois de criar uma Conexão MCP no Craft, copie o link MCP gerado ou as credenciais na aba Conexões. Os próximos passos acontecem fora do Craft. Abra a ferramenta compatível com MCP que você quer usar (por exemplo, um Assistente de IA ou um ambiente de desenvolvimento), encontre a opção para adicionar um servidor ou conector MCP e cole os dados que você copiou. A partir desse momento, a ferramenta terá acesso apenas às notas ou Documentos que você incluiu nessa conexão, conforme as permissões que você definiu.

​
Conexões MCP suportadas

Atualmente, o Craft oferece integrações MCP com:
  • Claude (Desktop e Claude Code)
  • ChatGPT
  • Windsurf
  • Cursor
  • Visual Studio Code
  • Raycast
  • Outros clientes MCP padrão
Essas ferramentas podem se conectar diretamente aos seus Documentos do Craft para ler e ajudar você com o conteúdo.

​
O que você pode fazer com o MCP

Com o MCP ativado, você pode:
  • Pedir a Assistentes de IA para analisar ou resumir seus Documentos
  • Gerar ou reescrever conteúdo com base nos seus Documentos do Craft
  • Usar ferramentas de desenvolvimento para criar fluxos de trabalho personalizados ou scripts usando o conteúdo do Craft
  • Interagir com seus Documentos a partir de ambientes de código como VS Code, Cursor ou Windsurf
  • Pesquisar e filtrar Documentos programaticamente
  • Estender o Craft com suas próprias ferramentas ou automações compatíveis com MCP
O MCP permite integrar o Craft com suas ferramentas favoritas de IA e desenvolvimento de forma transparente.

​
Usar MCP com vários Espaços

Cada conexão MCP no Craft está vinculada a um único espaço. Se você quiser dar a uma ferramenta externa acesso a documentos de vários espaços, precisa criar uma conexão MCP separada para cada espaço.
1
Abra o espaço que você quer conectar
2
Vá até a aba Conexões no sidebar e crie uma conexão MCP para esse espaço
3
Copie o endpoint MCP e adicione-o à sua ferramenta externa como um servidor MCP separado
4
Repita para cada espaço adicional que você quiser conectar
Sua ferramenta externa (por exemplo, Claude ou Cursor) vai listar cada espaço como um servidor MCP separado. Isso é intencional: mantém as permissões isoladas, para que o acesso a cada espaço seja controlado de forma independente.

​
Guias completos e documentação

Todas as instruções de configuração e guias de integração estão disponíveis em: 👉 https://www.craft.do/imagine/ Aqui você encontrará guias dedicados para Claude, ChatGPT e outras ferramentas MCP suportadas.

​
Solução de Problemas

Se você tiver problemas de conexão entre o Craft e seu cliente MCP (especialmente com ferramentas como o Claude, que são atualizadas com frequência), as etapas a seguir geralmente resolvem o problema:
1

Reconectar

Tente desconectar e reconectar o servidor MCP no seu aplicativo cliente.
2

Recriar o conector

Se reconectar não ajudou, remova o conector MCP do seu aplicativo cliente e configure-o novamente usando o mesmo link.
3

Recriar o link no Craft

Se o problema persistir, exclua a conexão MCP na aba Conexões do Craft e crie uma nova. Em seguida, adicione o novo link ao seu aplicativo cliente.
Alguns clientes MCP lançam atualizações com muita frequência, o que pode ocasionalmente quebrar conexões existentes. Essas etapas resolvem a maioria dos problemas, embora em casos raros você precise aguardar uma correção do aplicativo cliente.

Segurança do MCP

Saiba sobre os recursos de segurança do MCP e controles de acesso

Limitações do ChatGPT

Entenda as limitações atuais ao usar MCP com o ChatGPT