MarkIt

Conecta Claude o ChatGPT a tu biblioteca de MarkIt para buscar, guardar y establecer recordatorios en todo lo que has guardado.

GitHub

Prueba este MCPPatrocinado

Documentación

MarkIt MCP - conecta tu IA a tu biblioteca

Trae tu propia IA. MarkIt es la memoria.

[!TIP] El camino fácil (recomendado): pega la URL de este repositorio en tu IA y di "conéctame a MarkIt". Lee llms.txt y se encarga de todo lo demás por ti.

MarkIt guarda los enlaces, publicaciones y notas que de otro modo perderías, y los hace buscables en lenguaje natural. Este repositorio es la guía oficial para conectar tu propia IA - Claude, ChatGPT, Cursor y similares - a tu biblioteca de MarkIt a través del Model Context Protocol abierto.

Una vez conectado, tu IA puede buscar en tu biblioteca, leer lo que encuentre, guardar cosas nuevas en ella y establecer recordatorios. En tus palabras, no en palabras clave.

Server URL:  https://mark-it.co/api/mcp
Transport:   Streamable HTTP
Auth:        OAuth 2.1 (sign in) or a personal API key (mkt_...)

Elige tu camino

Opción 1 - Iniciar sesión (OAuth). Sin necesidad de manejar claves. Pega la URL del servidor donde tu aplicación pida un conector personalizado o servidor MCP, e inicia sesión en MarkIt cuando se abra el navegador. Mejor para Claude, ChatGPT web, Cursor, VS Code.

Opción 2 - Clave API. Genera una clave en Configuración > Integraciones (se muestra una vez, mantenla en secreto). Mejor para CLIs, scripts y la aplicación de escritorio de ChatGPT.

Opción 1 - inicia sesión desde tu aplicación

Instalaciones de un clic

Todos los demás

Aplicación	Pasos
Claude (claude.ai + Claude Desktop)	Configuración > Conectores (bajo Personalizar) > Añadir conector personalizado > pega `https://mark-it.co/api/mcp` > autoriza. Disponible en todos los planes (Free permite un conector personalizado). Problema conocido: un error abierto del lado de Anthropic puede fallar la autorización justo después de que apruebes - si eso ocurre, usa Claude Code (abajo) hasta que Anthropic publique la corrección.
ChatGPT (web)	Configuración > Seguridad e inicio de sesión > activa Modo desarrollador, luego Configuración > Plugins (o chatgpt.com/plugins) > + > pega la URL del servidor > conéctate con OAuth.
Claude Code	`claude mcp add --transport http markit https://mark-it.co/api/mcp` y luego ejecuta `/mcp` en una sesión y elige Autenticar. Añade `--scope user` para usarlo en cada proyecto.
Codex CLI	Añade el servidor (ver clients/codex.toml, omite la línea del token) y luego `codex mcp login markit`.
Zed	Añade una entrada `context_servers` solo con el `url` (ver clients/zed.json); Zed te guía a través de OAuth cuando no hay cabecera de Authorization.

Opción 2 - usa tu clave API

En Configuración de MarkIt > Integraciones, abre Conecta tu IA y genera tu clave. Empieza con mkt_ y se muestra una sola vez.
Toma la configuración de tu aplicación desde clients/ y reemplaza mkt_your_key_here:

Aplicación	Configuración
Claude Code	clients/claude-code.md
Cursor	clients/cursor.json
VS Code	clients/vscode.json
Codex CLI + aplicación de escritorio de ChatGPT	clients/codex.toml (comparten `~/.codex/config.toml`)
Windsurf	clients/windsurf.json
Cline	clients/cline.json
Zed	clients/zed.json
Cualquier cosa solo stdio	clients/mcp-remote.json

Reglas de la clave: una por cuenta, trátala como una contraseña, nunca la pegues en un chat, revócala o regenérala cuando quieras en Configuración.

Lo que tu IA obtiene

Herramienta	Qué hace
`search`	Búsqueda en lenguaje natural sobre tu biblioteca, con filtros opcionales (categoría, plataforma, tipo, autor, etiquetas, fechas).
`fetch`	Contenido completo almacenado de un elemento por id.
`list_categories`	Tus categorías con recuentos de elementos.
`save_item`	Guarda una URL o una nota de texto en tu biblioteca. MarkIt extrae, categoriza e indexa. Cada guardado consume una captura mensual; volver a guardar una URL que ya tienes es una operación gratuita sin efecto.
`create_reminder`	Establece o reprograma un recordatorio en un elemento (correo para todos; WhatsApp/Telegram en Pro).
`list_reminders`	Tus recordatorios pendientes.
`cancel_reminder`	Cancela un recordatorio por id. Nunca toca el elemento en sí; los recordatorios sincronizados con Google Calendar se gestionan en el sitio.
`send_feedback`	Envía una nota corta directamente al fundador de MarkIt - solo cuando se lo pidas. Una persona real lee cada una. Máximo 3 al día.

Lo que NO puede hacer, por diseño: eliminar elementos, editar tu cuenta, tocar los datos de nadie más. El contenido de las páginas guardadas se trata como datos, nunca como instrucciones.

Privacidad, en una frase

Tu IA habla con MarkIt con tu identidad y solo ve tus elementos. Cualquier IA que conectes (Claude, ChatGPT, ...) es tu propia herramienta bajo sus propios términos - MarkIt no envía tu biblioteca a ningún lugar por su cuenta. Los permisos de OAuth se pueden revocar desde tu aplicación de IA; la clave API se puede revocar en Configuración. Detalles completos: Política de privacidad.

Solución de problemas

401 justo después de conectar con una clave: la cabecera debe ser exactamente Authorization: Bearer mkt_... - verifica si falta un espacio o si la clave está truncada (regenerarla en Configuración invalida las claves antiguas).
Windsurf: el campo de servidor remoto es serverUrl, no url.
Cline: establece "type": "streamableHttp" explícitamente.
VS Code dice que no puede iniciar el servidor: una entrada con url también necesita "type": "http".
Claude dice "La autorización con MarkIt falló" justo después de que apruebes: error conocido del lado de Anthropic en conectores personalizados de claude.ai (nuestro servidor completa todo el flujo OAuth; Claude lo descarta después del token). Usa Claude Code o Cursor hasta que se corrija.
La ventana de inicio de sesión no vuelve: termina el inicio de sesión en la pestaña del navegador que se abrió, luego reintenta desde la aplicación; algunas aplicaciones necesitan un reintento después de la primera autorización.
Shim de mcp-remote: mantenlo actualizado (mcp-remote@latest; las versiones anteriores a 0.1.16 tienen una vulnerabilidad crítica conocida). Sin espacio alrededor de los dos puntos en Authorization:${AUTH_HEADER} en Windows.
¿Sigue atascado? support@mark-it.co.

Para tu IA

Apunta a tu asistente a llms.txt - un manual en texto plano que le enseña a conectarte y a usar bien las herramientas. Mismo archivo, URL con marca: mark-it.co/mcp/llms.txt.

Los usuarios de Claude Code pueden ir un paso más allá: copia la carpeta skill/ en .claude/skills/markit/ y Claude recoge automáticamente el manual completo de uso de MarkIt (cuándo buscar vs guardar, etiqueta de notas, manejo de recordatorios).

Licencia

MIT. El nombre y el logotipo de MarkIt pertenecen a MarkIt.