Guías de Integración

Conecta herramientas de código y agentes LLM a MatHub para automatizar la creación y edición de notas, notebooks y artifacts.

Conectar Claude Code

Conecta Claude Code (CLI de Anthropic) para editar notas, crear contenido y gestionar repositorios desde tu terminal.

1. Genera una API Key

Ve a Ajustes → Developer en MatHub y crea una nueva API key. Copia la clave — solo se muestra una vez.

2. Descarga la skill de MatHub

Claude Code puede descubrir la API automáticamente usando el endpoint skill.md. Agrega esta instrucción a tu archivo CLAUDE.md:

# MatHub Integration
Cuando trabajes con MatHub, usa la API documentada en:
curl -H "Authorization: Bearer mhub_TU_CLAVE" https://mathub.app/api/skill.md

Base URL: https://mathub.app
Auth header: Authorization: Bearer mhub_TU_CLAVE

3. Configura la autenticación

Exporta tu API key como variable de entorno para que Claude Code la use automáticamente:

export MATHUB_API_KEY="mhub_TU_CLAVE_AQUI"

4. Empieza a usar

Ahora puedes pedirle a Claude Code que interactúe con tus notas:

# Listar repositorios
claude "lista mis repositorios de MatHub usando la API"

# Crear una nota
claude "crea una nota en MatHub con un resumen de álgebra lineal"

# Editar una nota existente
claude "actualiza la nota X en MatHub, agrega una sección sobre eigenvalores"

Nota: Claude Code leerá el skill.md para conocer todos los endpoints disponibles y elegir los correctos automáticamente.

Endpoint de auto-descubrimiento

Todos los agentes pueden usar el endpoint GET /api/skill.md para obtener la documentación completa de la API en Markdown. Esto permite que el agente descubra endpoints, parámetros y formatos sin configuración manual.

curl -H "Authorization: Bearer mhub_TU_CLAVE" https://mathub.app/api/skill.md

Endpoints de validación

Útiles para verificar la integridad de notebooks y notas Lean antes de guardar cambios programáticos.

GET

/api/notes/:noteId/cells/validate

Valida la estructura de un notebook Python. Retorna valid, cellCount, y un array de issues.

GET

/api/notes/:noteId/lean/validate

Valida una nota Lean. Retorna valid, format (plain|json), y issues.