Saltar al contenido principal
Craft se vuelve más flexible y potente con la introducción de nuestra API. Esta nueva capacidad te permite conectar Craft con herramientas externas, automatizar flujos de trabajo y crear integraciones personalizadas que adapten Craft a tus necesidades.

¿Qué es una API?

Una API (Application Programming Interface) permite que distintas aplicaciones se comuniquen entre sí de forma segura. En la práctica, esto significa que puedes usar la API de Craft para:
  • Enviar o recibir datos desde otros servicios
  • Disparar acciones en Craft en respuesta a eventos en otra app
  • Crear herramientas, paneles o automatizaciones personalizados
  • Conectar Craft con asistentes de IA como Claude o ChatGPT a través de MCP u otros métodos de integración
Las API permiten que Craft funcione de forma fluida junto a las herramientas que ya usas – sin copiar manualmente ni repetir tareas.

Cómo funciona la API de Craft

Crea una Conexión API desde la pestaña Imagine en la barra lateral para compartir las partes correctas de tu espacio de trabajo con herramientas externas. Puedes elegir:
  • Conectar todas tus Notas Diarias, o
  • Crear una conexión personalizada donde selecciones uno o más Documentos específicos para incluir
Para cada conexión, configuras los permisos de acceso y la visibilidad, así que mantienes el control de lo que se comparte. Craft generará un endpoint único de API para esa conexión, que puedes usar en tus herramientas o flujos de trabajo basados en API. Esas herramientas solo podrán acceder a los Documentos que seleccionaste, mientras que el resto de tu espacio de trabajo permanecerá privado. Puedes crear, revisar y administrar todas tus conexiones API en Craft - Configuración → API Gestión de conexiones API en Configuración Después de crear una Conexión API en Craft, copia el endpoint de la API y las credenciales que se muestran en la pestaña Imagine. Luego lleva estos datos a la app externa o al flujo de trabajo que quieras conectar (por ejemplo, un Asistente de IA, una herramienta de automatización o un entorno de desarrollo) y agrégalos en su conector o en los ajustes de integración de API. Cada herramienta maneja esto de forma un poco distinta, pero la idea es la misma: pegas los datos de la API de Craft allí, y la herramienta solo podrá acceder a los Documentos que seleccionaste para esa conexión.
La API de Craft ahora soporta acceso completo a nivel de Espacio con capacidades avanzadas:
  • Buscar en todos los Documentos con filtrado por Carpetas, Etiquetas y fecha
  • Notas Diarias y Tareas son totalmente accesibles vía API
  • Crear, actualizar y eliminar Documentos de forma programática
  • Gestión de Colecciones incluyendo creación y edición de esquemas
  • Búsqueda avanzada con soporte de regex y filtros de fecha conscientes de la zona horaria
Consulta la documentación oficial de la API para obtener detalles completos de los endpoints.

Casos de uso

Aquí tienes algunos ejemplos de lo que puedes construir con la API:
  • Un panel personal que se actualiza automáticamente
  • Una lista de Tareas que se sincroniza con otra app de productividad
  • Un registro de lectura que obtiene datos de una fuente externa
  • Un Asistente de IA personalizado adaptado a tus Documentos de Craft
  • Creación automática de Documentos a partir de plantillas
  • Copias de seguridad o exportaciones programadas
  • Integración con herramientas de comunicación para equipos
Las posibilidades son amplias – la API te permite extender Craft como lo imagines.

Guías completas y documentación

Todas las guías paso a paso para la API, conexiones MCP y ejemplos de integraciones (incluyendo Claude y ChatGPT) están disponibles aquí: 👉 https://www.craft.do/imagine/ Este es el mejor lugar para explorar tutoriales, aprender a habilitar MCP y entender cómo conectar Craft con herramientas de terceros. Si necesitas ayuda para empezar o tienes preguntas, no dudes en contactarnos – estamos aquí para ayudarte.