Instala Markitdown como MCP para Claude: Reduce el consumo de tokens a la mitad convirtiendo PDFs a Markdown
Guía completa para instalar el conversor open-source de Microsoft, conectarlo a Claude Desktop vía MCP y procesar documentos PDF, Word y Excel gastando hasta un 90% menos de tokens.
Por Martin Reche ·
Martin Reche · Sistemas de conversión con IA para negocios
Hemos construido sistemas de conversión para más de 50 negocios: desde el anuncio en Meta Ads hasta el cliente cerrado, pasando por la cualificación del lead y la venta. Todo lo que ves en esta guía está funcionando en negocios reales.
EL PROBLEMA Y LA SOLUCIÓN
Por qué Claude gasta tantos tokens con PDFs y cómo arreglarlo
Cuando arrastras un PDF directamente a Claude, el sistema lo codifica en base64 o procesa el binario crudo, consumiendo una cantidad masiva de tokens (a veces 50.000+ tokens para un documento de 10 páginas). Markitdown, la herramienta open-source de Microsoft, convierte cualquier PDF, Word, Excel o PowerPoint en Markdown limpio y estructurado antes de enviarlo a Claude. El truco es configurarlo como servidor MCP (Model Context Protocol): Claude llama a Markitdown automáticamente, recibe el texto plano y procesa el contenido real del documento gastando un 80-90% menos de tokens, con mejor comprensión de tablas y formato.
El flujo completo
1. Instala
Markitdown en tu sistema con Python
2. Conecta
Configúralo como servidor MCP en Claude Desktop
3. Ahorra
Arrastra PDFs y deja que Claude convierta antes de leer
Resultado tangible: Un contrato de 20 páginas que antes consumía 45.000 tokens, ahora consume 3.000 tokens. Con la API de Claude 3.5 Sonnet, eso es la diferencia entre pagar $0.65 y $0.04 por documento.
VÍA RÁPIDA (RECOMENDADA)
Que Claude Code lo instale todo por ti
Si tienes Claude Code instalado (el agente de Anthropic para terminal), no necesitas tocar comandos ni editar archivos JSON manualmente. Copia este prompt y pégaselo a Claude Code. Él instalará Markitdown, detectará tu sistema operativo, editará el archivo de configuración de Claude Desktop con las rutas correctas y verificará que todo funcione.
Necesito instalar markitdown de Microsoft (https://github.com/microsoft/markitdown) y configurarlo como servidor MCP en Claude Desktop. Por favor hazlo todo por mí:
1. Verifica si tengo Python instalado y si no, indícame cómo instalarlo (pero no lo instales tú por seguridad)
2. Instala markitdown con pip: `pip install markitdown` (o python3 -m pip install markitdown en Mac/Linux)
3. Localiza el archivo de configuración de Claude Desktop en mi sistema según el OS (Windows: %APPDATA%\Claude\settings.json o claude_desktop_config.json, Mac: ~/Library/Application Support/Claude/settings.json, Linux: ~/.config/Claude/)
4. Edita ese archivo JSON y añade la configuración del servidor MCP para markitdown usando el comando `python -m markitdown --mcp` (adapta a python3 si es necesario)
5. Reinicia Claude Desktop y verifica que el servidor MCP aparece conectado (debería salir un icono de herramienta o "markitdown" en los settings)
6. Crea un archivo de prueba markdown desde un PDF de ejemplo si es posible
Ve contándome exactamente qué pasos realizas y qué rutas modificas para que yo lo sepa.¿No tienes Claude Code? Es un agente que se instala en tu terminal con `npm install -g @anthropics/anthropic-ai`. Si prefieres no instalarlo nada más, salta a la sección 04 para hacerlo todo manual paso a paso.
REQUISITOS
Lo que necesitas antes de empezar (vía manual)
Python 3.10+
Markitdown requiere Python. Verifica con `python --version` o `python3 --version`
python3 --versionClaude Desktop
La aplicación oficial de Anthropic (no la web). Descárgala desde anthropic.com
claude.ai/downloadpip (gestor de paquetes)
Viene con Python. Lo usaremos para instalar markitdown
pip --version¿Te trabas en algún paso? Lo vemos en una llamada desde 49€, con acciones por escrito.
Ver sesionesINSTALACIÓN MANUAL
Paso a paso: Instalar Markitdown y configurar el MCP
Instala Markitdown vía pip
Abre tu terminal (CMD en Windows, Terminal en Mac, o tu shell en Linux) y ejecuta el comando de instalación. Esto descarga la herramienta y la hace disponible como comando en tu sistema.
pip install markitdownpython3 -m pip install markitdownSi ves un error de "pip no encontrado", prueba con `python -m pip install markitdown` (Windows) o instala pip primero.
Verifica la instalación y encuentra la ruta
Comprueba que se instaló correctamente y localiza dónde está el ejecutable. Necesitamos esta ruta para el archivo de configuración.
where markitdown
where pythonwhich markitdown
which python3Lo que deberías ver: Una ruta como `C:\Users\TuNombre\AppData\Local\Programs\Python\Python311\python.exe` (Windows) o `/usr/local/bin/python3` (Mac). Anota la ruta de Python, la usaremos en el paso 4.
Localiza el archivo de configuración de Claude Desktop
Claude Desktop guarda su configuración MCP en un archivo JSON específico según tu sistema operativo. Debes abrirlo con un editor de texto.
- Windows: Presiona `Win + R`, pega `%APPDATA%\Claude` y presiona Enter. Busca el archivo llamado `settings.json` o `claude_desktop_config.json`.
- Mac: Abre Finder, presiona `Cmd + Shift + G`, pega `~/Library/Application Support/Claude` y busca `settings.json`.
- Linux: Navega a `~/.config/Claude/` y busca `settings.json`.
Si el archivo no existe, créalo. Si ya existe, ábrelo con un editor de texto plano (VS Code, Notepad, TextEdit) sin formato.
Añade la configuración del servidor MCP
Edita el archivo JSON para añadir Markitdown como servidor MCP. Si el archivo está vacío, usa la primera opción. Si ya tiene contenido, añade solo la sección de markitdown dentro de `mcpServers`.
{
"mcpServers": {
"markitdown": {
"command": "python3",
"args": ["-m", "markitdown", "--mcp"]
}
}
}{
"mcpServers": {
"markitdown": {
"command": "python",
"args": ["-m", "markitdown", "--mcp"]
}
}
}Si ya tienes otros servidores MCP configurados: Simplemente añade la sección `"markitdown": { ... }` dentro del objeto `mcpServers`, separada por comas de las demás.
Guarda y reinicia Claude Desktop
Guarda el archivo JSON (Ctrl+S o Cmd+S). Cierra completamente Claude Desktop (no solo minimizar, sal del icono de la bandeja/sistema) y vuelve a abrirlo. Esto carga la nueva configuración MCP.
VERIFICACIÓN
Cómo saber si Markitdown está funcionando
Busca el icono de herramientas
Abre cualquier conversación en Claude Desktop. Si la instalación funcionó, verás un icono de martillo 🔨 o un mensaje en la parte inferior indicando que hay herramientas MCP disponibles. También puedes ir a Settings → Developer y verificar que 'markitdown' aparece en la lista de MCP Servers con status 'connected'.
Prueba con un documento real
Arrastra cualquier PDF, Word (.docx) o Excel (.xlsx) a la conversación de Claude. Ahora deberías ver que Claude primero 'llama' a la herramienta markitdown para convertir el archivo antes de procesarlo. El tiempo de carga será mucho menor y verás el contenido en formato Markdown limpio en lugar de texto binario.
ERRORES COMUNES
Si algo falla, aquí está la solución
Claude dice 'MCP server disconnected' o no aparece markitdown
Revisa que la ruta de Python en el JSON sea correcta. En Windows prueba con la ruta completa (ej: C:\\Users\\...\\python.exe) en lugar de solo 'python'. Asegúrate de que las comillas del JSON sean dobles, no simples.
'command not found: markitdown' al probar en terminal
Esto es normal si no está en el PATH. Por eso usamos `python -m markitdown` en la configuración MCP en lugar de llamar directamente a markitdown.
Markitdown instala pero Claude no lo detecta tras reiniciar
En Mac/Linux, asegúrate de usar `python3` en el comando del JSON, no `python`. En Windows, si usas la Microsoft Store de Python, la ruta puede ser especial; usa `where python` para copiar la ruta exacta y pégala en el campo 'command' entre comillas.
Los PDFs escaneados (imágenes) no se convierten
Markitdown tiene OCR integrado pero requiere dependencias adicionales. Si falla con imágenes, instala: `pip install markitdown[ocr]` (requiere Tesseract instalado en el sistema).
APLICACIONES REALES
Qué puedes hacer ahora con esto
📄
Auditoría de contratos
Pásale 50 contratos PDF y pídele que extraiga todas las cláusulas de confidencialidad a una tabla Excel. Costo antes: $30 en tokens. Costo ahora: $2.
📊
Análisis de Excel masivo
Convierte hojas de cálculo complejas a Markdown tabulado y pide análisis estadísticos sin que Claude se pierda en el formato binario de Excel.
🎯
Procesamiento de facturas
Automatiza la extracción de datos de facturas PDF escaneadas (con OCR) directamente a tu sistema contable vía API, gastando mínimos tokens por documento.
📑
Resumen de presentaciones
Convierte archivos .pptx de 100 diapositivas a texto estructurado y genera resúmenes ejecutivos en segundos sin que se corte el contexto por exceso de tokens.
Repositorio oficial de Markitdown
Documentación completa, updates y reporte de issues directamente en el repo de Microsoft.
Si quieres ir más rápido
Sistemas de conversión que funcionan, no demos de IA
Soy Martin Reche. Hemos construido sistemas de conversión para más de 50 negocios: desde el anuncio en Meta Ads hasta el cliente cerrado, pasando por la cualificación del lead y la venta. Todo lo que ves en esta guía está funcionando en negocios reales. Si quieres aplicarlo a tu caso, lo vemos en una llamada: te digo qué montar, con qué y en qué orden, y te lo dejo por escrito. Y si prefieres que lo montemos por ti, eso es NovaChat.
Sistemas de conversión
Del anuncio al cliente cerrado: captación, seguimiento y venta en un solo flujo que funciona.
Cualificación de leads
Cada contacto se filtra, se atiende y se lleva a la venta sin que nadie lo persiga a mano.
Agentes de IA que atienden y venden
Voz, WhatsApp, web e Instagram: responden, cualifican y cierran citas 24/7.
Consultoría 1:1
Desde 49 €: te digo qué montar, con qué y en qué orden, por escrito.
Consultoría 1:1 · Google Meet
Una llamada y sales sabiendo qué hacer y qué no
Me cuentas tu caso en un formulario de dos minutos, pagas, eliges hora. Garantía simple: si en los primeros 10 minutos veo que no te puedo ayudar, te devuelvo el importe. Pack de 3 Revisiones por 249 € si quieres que te acompañe 90 días.
49€
30 min · Diagnóstico 1:1
99€
60 min · Revisión 1:1
149€
90 min · Estrategia 1:1
¿Prefieres que lo montemos por ti?
En NovaChat IA construimos agentes de voz, chatbots y automatizaciones para pymes. Tú lo usas, nosotros lo mantenemos.