Modelos locales: Ollama + Goose

Un modelo local no se conecta a md-doc directamente: lo hace el cliente que lo usa. Con Ollama sirviendo el modelo y Goose como cliente MCP, tu modelo local lee y escribe las mismas notas, bitácoras e issues que Claude o ChatGPT.

Está probado con esta combinación. Otros clientes con soporte MCP por HTTP deberían funcionar igual, pero no los hemos verificado.

Requisitos

• Ollama instalado y en marcha.
• Un modelo que soporte llamadas a herramientas (tool calling). Sin eso, el modelo no puede usar el MCP.
• Goose instalado.
• Una clave de API de tipo MCP: Primeros pasos.

Pasos

1. Descarga un modelo con soporte de herramientas, por ejemplo:

   ollama pull qwen3

2. Configura Goose con Ollama como proveedor:

   goose configure

   Elige Configure Providers → Ollama y el modelo.

3. Añade md-doc como extensión remota. En goose configure → Add Extension → extensión remota por HTTP, con:

   • Nombre: md-doc
   • URL: https://app.md-doc.com/api/mcp
   • Cabecera: Authorization: Bearer mcp_TU_CLAVE

   Si prefieres editar el fichero de configuración de Goose, la extensión queda así (comprueba los nombres de campo de tu versión):

   extensions:
     md-doc:
       type: streamable_http
       uri: https://app.md-doc.com/api/mcp
       headers:
         Authorization: Bearer mcp_TU_CLAVE
       enabled: true

4. Inicia una sesión con goose session y pide algo como «lista mis issues abiertas en md-doc».

Consejos

• Los modelos pequeños fallan más al elegir herramientas. Si dudas, prueba primero con peticiones sencillas (buscar, listar).
• Para usar secretos, el modelo necesita terminal; mira el CLI mddoc.