Pular para o conteúdo principal
Conecte assistentes de IA e ferramentas de desenvolvimento ao seu conteúdo do Craft por meio do MCP (Model Context Protocol).

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

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. Ao criar uma conexão, escolha o que ela inclui:
  • Conectar Notas Diárias e Tarefas: suas Notas Diárias e tarefas
  • Conectar Documentos Selecionados: um ou mais documentos que você escolher
  • Conectar Todos os Documentos: todos os documentos do Espaço
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
Uma conexão com acesso a todos os documentos de um Espaço oferece:
  • 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.
Para criar novos Documentos ou Coleções via MCP, a conexão precisa estar configurada como Conectar Todos os Documentos (e não uma lista personalizada de documentos específicos), com as permissões de escrita ativadas. Uma conexão limitada a documentos específicos ou configurada como somente leitura consegue ler, pesquisar e acrescentar conteúdo, mas não consegue criar conteúdo novo.

Use Craft with ChatGPT

Use o plugin do Craft para pesquisar suas notas, resumir documentos e criar ou atualizar conteúdo a partir do ChatGPT.
  1. Abra a página do plugin Craft e selecione Install plugin.
  2. Siga as instruções de conexão e entre na sua conta Craft se solicitado.
  3. Revise o acesso solicitado e conclua a autorização.
Depois de conectar, mencione o Craft com @ ou selecione-o no menu de ferramentas do chat. Por exemplo, pergunte: “Encontre minhas notas sobre onboarding e resuma as questões em aberto.” O ChatGPT pode acessar o conteúdo que você autorizar. Você pode gerenciar ou desconectar essa conexão nas configurações de Apps ou Plugins do ChatGPT.
Se o Craft estiver indisponível, verifique a mensagem na página do plugin. Se o acesso estiver desativado por um administrador, peça ao administrador do seu workspace para habilitá-lo.

Use Craft with Claude

Adicione sua conexão MCP do Craft ao Claude como um conector personalizado.
1
No Craft, abra a aba Conexões na sidebar e crie uma conexão MCP para o Espaço que você quer usar.
2
Abra a conexão e copie a URL dela.
3
No Claude, acesse Settings > Connectors e selecione Add custom connector.
4
Digite um nome, cole a URL e selecione Add.
Para ver instruções passo a passo com a URL da sua conexão já preenchida, abra a conexão no Craft e selecione Claude em Ver Guia de Integração Para….

Conectar outra ferramenta compatível com MCP

Para outras ferramentas compatíveis com MCP, crie uma conexão MCP no Craft, copie o link MCP gerado ou as credenciais na aba Conexões e adicione-os nas configurações de MCP ou de conector da ferramenta externa. A ferramenta terá acesso apenas às notas ou Documentos incluídos 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 (por meio do plugin Craft)
  • 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

Usar MCP com vários Espaços

Plugin do ChatGPT: Você pode conectar vários espaços do Craft. Abra a página do plugin do Craft no ChatGPT e, em Connected accounts (Contas conectadas), selecione Connect another account (Conectar outra conta). Durante a autorização no Craft, entre na sua conta se solicitado, selecione o espaço adicional e autorize o acesso. Repita para cada espaço que quiser adicionar. Apesar do nome do botão, você pode selecionar outro espaço da mesma conta do Craft. Conexões MCP manuais: Cada conexão está vinculada a um único espaço. Crie uma conexão MCP separada para cada espaço que quiser adicionar:
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
Em conexões MCP manuais, adicione o link de cada espaço separadamente na sua ferramenta externa.
As conexões MCP só funcionam com Espaços do Craft sincronizados na nuvem. Espaços em External Location (armazenados localmente, por exemplo em uma pasta do iCloud) não têm um endpoint no servidor, então a opção Criar Conexão MCP não funciona para eles.

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/ Para o plugin do ChatGPT, siga Use Craft with ChatGPT. A documentação para desenvolvedores cobre conexões MCP manuais e outras integrações.

Solução de Problemas

Para uma conexão MCP manual que parou de funcionar, tente as etapas a seguir. Para o plugin do ChatGPT, revise a conexão nas configurações de Apps ou Plugins do ChatGPT e reconecte se solicitado.
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