Feedjoltdocs
DesarrolladoresMCP

Configuración de MCP

Conecta Feedjolt con Claude Desktop, Cursor y Windsurf mediante MCP. OAuth con una URL es la opción por defecto; las claves de API siguen siendo una alternativa completa.

Lo habitual es una URL y ninguna clave. Copia un conector por chat. Si pones los dos en el mismo mcp.json, las herramientas de mutación quedan junto al texto de clientes. El cliente descubre OAuth, abre el navegador, apruebas. Detalles en OAuth.

Chat Reader:

{
  "mcpServers": {
    "feedjolt-reader": {
      "url": "https://api.feedjolt.com/mcp/reader/"
    }
  }
}

Chat Writer (otro proyecto de Claude, chat de ChatGPT o workspace de Cursor):

{
  "mcpServers": {
    "feedjolt-writer": {
      "url": "https://api.feedjolt.com/mcp/writer/"
    }
  }
}

El combinado https://api.feedjolt.com/mcp/ sigue funcionando. Trátalo como legado e inseguro.

Clave de API (alternativa)

Las claves de API no se retiran. Si quieres una credencial fjk_ fija, usa los fragmentos de abajo. Crea una clave en Claves de API.

Claude Desktop

Abre ~/Library/Application Support/Claude/claude_desktop_config.json y añade un conector. Esto es Reader:

{
  "mcpServers": {
    "feedjolt-reader": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.feedjolt.com/mcp/reader/",
        "--header",
        "Authorization: Bearer fjk_YOUR_KEY"
      ]
    }
  }
}

Writer es el mismo bloque con feedjolt-writer y https://api.feedjolt.com/mcp/writer/. Ponlo en otro proyecto de Claude. No listes los dos en este archivo.

Claude Desktop no habla Streamable HTTP directamente - mcp-remote es un pequeño puente stdio↔HTTP que el Node integrado descarga en el primer arranque. Reinicia Claude Desktop. Las herramientas de Feedjolt aparecerán en el selector de herramientas.

Cursor

En los ajustes de Cursor → MCP, añade un conector por workspace. Esto es Reader:

{
  "mcpServers": {
    "feedjolt-reader": {
      "transport": "http",
      "url": "https://api.feedjolt.com/mcp/reader/",
      "headers": { "Authorization": "Bearer fjk_YOUR_KEY" }
    }
  }
}

Writer es lo mismo con feedjolt-writer y /mcp/writer/, en otro workspace de Cursor.

Windsurf

Mismo puente mcp-remote que Claude Desktop. Ruta: ~/.codeium/windsurf/mcp_config.json.

Cliente MCP genérico

El servidor habla Streamable HTTP (especificación MCP 2025-03-26). Envía envoltorios JSON-RPC a la URL. Los clientes OAuth mandan un token Bearer de acceso tras el consentimiento. Los clientes con clave de API mandan Authorization: Bearer fjk_... (o X-API-Key).

On this page