MCP-server

Ragmind exponerar en Model Context Protocol-server så att Claude Desktop, Claude Code, Hermes och andra MCP-klienter kan söka, läsa och ställa frågor mot ditt dokumentbibliotek.

Endpoint

https://api.ragmind.yashuragi.se/mcp/

Transport: Streamable HTTP. Auth: Bearer-token från API-tokens.

Exponerade tools

TOOL	SCOPE	BESKRIVNING
search_documents	documents:read	Topp-k chunks via dense retrieval.
list_documents	documents:read	Paginated lista med dokument-metadata.
list_agents	agents:read	Tillgängliga Ragmind-agenter.
ask	chat:write	Full RAG-pipeline: hämta chunks + LLM-svar med default eller specifik agent.

Anslut Claude Desktop

Lägg i claude_desktop_config.json (eller motsvarande klient-config):

{
  "mcpServers": {
    "ragmind": {
      "url": "https://api.ragmind.yashuragi.se/mcp/",
      "headers": {
        "Authorization": "Bearer rgmd_DIN_TOKEN_HÄR"
      }
    }
  }
}

Manuell test med curl

Initialize-handshake (måste komma först — Streamable HTTP):

curl -X POST https://api.ragmind.yashuragi.se/mcp/ \
  -H "Authorization: Bearer rgmd_DIN_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"manual","version":"1.0"}}}'

Servern svarar med en mcp-session-id-header som du måste skicka med på efterföljande requests för samma session.

Rekommenderade scopes per användning

Read-only sökning: documents:read räcker för search_documents och list_documents.
Frågesvar via Ragmind-agent: documents:read + chat:write + agents:read.
Allt: * ger full åtkomst — använd med försiktighet och bara för betrodda integrationer.