> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# MCP
> Conecte o Craft com assistentes de IA e ferramentas de desenvolvimento usando o Model Context Protocol.
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 Imagine** 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.
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](https://www.craft.do/imagine/) para detalhes completos.
Depois de criar uma Conexão MCP no Craft, copie o link MCP gerado ou as credenciais na aba Imagine. 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.
## 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/**](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:
Tente desconectar e reconectar o servidor MCP no seu aplicativo cliente.
Se reconectar não ajudou, remova o conector MCP do seu aplicativo cliente e configure-o novamente usando o mesmo link.
Se o problema persistir, exclua a conexão MCP na aba Imagine 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.
Saiba sobre os recursos de segurança do MCP e controles de acesso
Entenda as limitações atuais ao usar MCP com o ChatGPT