Feedjoltdocs
DesenvolupadorsMCP

Configuració de MCP

Connecta Feedjolt amb Claude Desktop, Cursor i Windsurf mitjançant MCP. OAuth amb una URL és l'opció per defecte; les claus d'API continuen sent una alternativa completa.

El que toca per defecte és una URL i cap clau. Copia un connector per xat. Si poses tots dos al mateix mcp.json, les eines de mutació queden al costat del text de clients. El client descobreix OAuth, obre el navegador, ho aproves. Detalls a OAuth.

Xat Reader:

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

Xat Writer (un altre projecte de Claude, xat de ChatGPT o workspace de Cursor):

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

El combinat https://api.feedjolt.com/mcp/ continua funcionant. Tracta'l com a llegat i insegur.

Clau d'API (alternativa)

Les claus d'API no es retiren. Si vols una credencial fjk_ fixa, fes servir els fragments de sota. Crea una clau a Claus d'API.

Claude Desktop

Obre ~/Library/Application Support/Claude/claude_desktop_config.json i afegeix un connector. Això és Reader:

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

Writer és el mateix bloc amb feedjolt-writer i https://api.feedjolt.com/mcp/writer/. Posa'l en un altre projecte de Claude. No els llistis tots dos en aquest fitxer.

Claude Desktop no parla Streamable HTTP directament - mcp-remote és un petit pont stdio↔HTTP que el Node integrat baixa al primer arrencament. Reinicia Claude Desktop. Les eines de Feedjolt apareixeran al selector d'eines.

Cursor

A la configuració de Cursor → MCP, afegeix un connector per workspace. Això és Reader:

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

Writer és el mateix amb feedjolt-writer i /mcp/writer/, en un altre workspace de Cursor.

Windsurf

Mateix pont mcp-remote que Claude Desktop. Ruta: ~/.codeium/windsurf/mcp_config.json.

Client MCP genèric

El servidor parla Streamable HTTP (especificació MCP 2025-03-26). Envia embolcalls JSON-RPC a la URL. Els clients OAuth envien un token Bearer d'accés després del consentiment. Els clients amb clau d'API envien Authorization: Bearer fjk_... (o X-API-Key).

On this page