Pular para o conteúdo principal
O Craft está ficando mais flexível e poderoso com a introdução da nossa API. Essa nova capacidade permite que você conecte o Craft a ferramentas externas, automatize fluxos de trabalho e crie integrações personalizadas que adaptam o Craft às suas necessidades.

​
O que é uma API?

Uma API (Application Programming Interface) permite que aplicações diferentes se comuniquem entre si de forma segura. Na prática, isso significa que você pode usar a Craft API para:
  • Enviar ou receber dados de outros serviços
  • Disparar ações no Craft com base em eventos em outro app
  • Construir ferramentas, painéis ou automações personalizados
  • Conectar o Craft a Assistentes de IA como Claude ou ChatGPT através do MCP ou outros métodos de integração
As APIs possibilitam que o Craft funcione em conjunto com as ferramentas que você já usa – sem cópias manuais ou tarefas repetitivas.

​
Como a Craft API funciona

Crie uma API Connection na Imagine tab no sidebar para compartilhar as partes certas do seu workspace com ferramentas externas. Você pode escolher:
  • Conectar todas as suas Notas Diárias, ou
  • Criar uma conexão personalizada onde você seleciona um ou mais Documentos específicos para incluir
Para cada conexão, você define as permissões de acesso e a visibilidade, para que você mantenha o controle do que é compartilhado. O Craft então gera um API endpoint único para essa conexão, que você pode inserir nas suas ferramentas ou fluxos de trabalho baseados em API. Essas ferramentas só terão acesso aos Documentos que você selecionou – todo o resto na sua área de trabalho permanece privado. Você pode criar, revisar e gerenciar todas as suas conexões de API em Configurações do Craft → API Gerenciamento da conexão API em Configurações Depois de criar uma API Connection no Craft, copie o API endpoint e as credenciais mostradas na Imagine tab. Em seguida, leve essas informações para o app externo ou fluxo de trabalho que você quer conectar (por exemplo, um Assistente de IA, uma ferramenta de automação ou um ambiente de desenvolvedor) e cole-as nas configurações do conector ou integração de API. Cada ferramenta lida com isso de maneira um pouco diferente, mas a ideia é a mesma: você cola os dados da Craft API lá, e a ferramenta passa a acessar apenas os Documentos selecionados para essa conexão.
A Craft API agora oferece acesso completo em nível de Espaço com capacidades avançadas:
  • Pesquisar por todos os Documentos com filtros por Pastas, Tags e data
  • Notas Diárias e Tarefas totalmente acessíveis via API
  • Criar, atualizar e excluir Documentos programaticamente
  • Gerenciamento de Coleções incluindo criação e edição de schema
  • Busca avançada com suporte a regex e filtros de data sensíveis ao fuso horário
Consulte a documentação oficial da API para detalhes completos dos endpoints.

​
Casos de uso

Abaixo estão alguns exemplos do que você pode construir com a API:
  • Um painel pessoal que atualiza automaticamente
  • Uma lista de tarefas que sincroniza com outro app de produtividade
  • Um registro de leitura que busca dados de uma fonte externa
  • Um assistente personalizado com IA feito sob medida para os seus Documentos do Craft
  • Criação automática de Documentos a partir de modelos
  • Backups ou exportações programadas
  • Integração com ferramentas de comunicação da equipe
As possibilidades são amplas - a API permite estender o Craft do jeito que você imaginar.

​
Guias completos e documentação

Todos os guias passo a passo para a API, conexões MCP e integrações de exemplo (incluindo Claude e ChatGPT) estão disponíveis aqui: 👉 https://www.craft.do/imagine/ Esse é o melhor lugar para explorar tutoriais, aprender como ativar o MCP e entender como conectar o Craft a ferramentas de terceiros. Se você precisar de ajuda para começar ou tiver perguntas, fique à vontade para entrar em contato conosco - estamos aqui para ajudar.