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

Usa 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 conectada, 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 gestionar 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. Ideal para Claude, ChatGPT web, Cursor, VS Code.

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

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

Instalaciones en un clic

Para el resto

Aplicación	Pasos
Claude (claude.ai + Claude Desktop)	Settings > Connectors (en Customize) > Add custom connector > pega `https://mark-it.co/api/mcp` > autoriza. Disponible en todos los planes (Free permite un conector personalizado). Problema conocido: un bug del lado de Anthropic puede hacer fallar la autorización justo después de que apruebes; si ocurre, usa Claude Code (abajo) hasta que Anthropic publique la corrección.
ChatGPT (web)	Settings > Security and login > activa Developer mode, luego Settings > 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 Authenticate. Añade `--scope user` para usarlo en todos los proyectos.
Codex CLI	Añade el servidor (consulta 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` (consulta clients/zed.json); Zed te guía por OAuth cuando no hay cabecera Authorization.

Opción 2 - usa tu clave API

En MarkIt Settings > Integrations, abre Connect Your AI y genera tu clave. Empieza con mkt_ y se muestra una sola vez.
Toma la configuración de tu aplicación de 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 Settings.

Lo que tu IA obtiene

Herramienta	Qué hace
`search`	Búsqueda en lenguaje natural en 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 el número de elementos.
`save_item`	Guarda una URL o una nota de texto en tu biblioteca. MarkIt extrae, categoriza e indexa el contenido. 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 breve 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 sitio por su cuenta. Los permisos de OAuth se pueden revocar desde tu aplicación de IA; la clave API se puede revocar en Settings. Detalles completos: Privacy Policy.

Solución de problemas

401 justo después de conectar con una clave: la cabecera debe ser exactamente Authorization: Bearer mkt_... - comprueba si falta un espacio o si la clave está truncada (regenerarla en Settings 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 "Authorization with MarkIt failed" justo después de que apruebes: bug conocido del lado de Anthropic en los 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 a aparecer: termina el inicio de sesión en la pestaña del navegador que abrió, y 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 las notas, gestión de recordatorios).

Licencia

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