MCP

Neleto unterstützt das Model Context Protocol (MCP), mit dem KI-Agenten - wie GitHub Copilot, Claude oder Cursor - über natürliche Sprache direkt mit deinem CMS interagieren können.

Verbundene Agenten können Inhalte lesen und schreiben: Seiten erstellen, Dateien verwalten, Blogbeiträge aktualisieren, Events auflisten und vieles mehr - alles direkt aus dem Editor heraus.

Endpunkt

Deine Neleto-Instanz stellt einen JSON-RPC 2.0 MCP-Endpunkt bereit:

POST <deine-neleto-url>/api/mcp

Authentifizierung

Alle Anfragen benötigen einen Bearer-Token. API-Tokens erstellst du in deinen Profileinstellungen unter Profil -> Sicherheit (erreichbar über das Profil-Symbol oben rechts oder über die Suche).

Authorization: Bearer <dein-token>

Für Tools, die den OAuth-Ablauf automatisch durchführen (wie Claude Custom Connectors), siehe Claude Custom Connector (OAuth) weiter unten.

Claude Custom Connector (OAuth)

Claudes Custom Connectors (claude.ai und Claude Desktop) authentifizieren sich bei entfernten MCP-Servern per OAuth 2.1 statt mit einem manuell eingefügten Token. Neleto ist ein integrierter OAuth-2.1-Autorisierungsserver, daher ist keine Token-Einrichtung nötig: Claude registriert sich automatisch und du musst dich nur anmelden und die Verbindung bestätigen.

1. Öffne in Claude Einstellungen -> Connectors -> Custom Connector hinzufügen.
2. Gib die URL deines MCP-Endpunkts ein: https://deine-neleto-instanz.com/api/mcp
3. Claude ermittelt den Autorisierungsserver und öffnet deine Neleto-Instanz im Browser. Melde dich an (falls noch nicht geschehen) und bestätige den Anwendung verbinden-Dialog.
4. Claude wird zurückgeleitet und erhält automatisch ein Access-Token. Der Connector ist nun einsatzbereit.

Im Hintergrund stellt Neleto die standardisierten Discovery- und OAuth-Endpunkte bereit:

• GET /.well-known/oauth-protected-resource (RFC 9728)
• GET /.well-known/oauth-authorization-server (RFC 8414)
• POST /api/oauth/register — Dynamic Client Registration (RFC 7591)
• GET /api/oauth/authorize und POST /api/oauth/token — Authorization-Code-Flow mit PKCE

Ausgestellte Access-Tokens sind kurzlebig und werden automatisch erneuert. Jede Autorisierung ist an den bestätigenden Benutzer gebunden und erbt dessen Berechtigungen.

Verbundene Anwendungen verwalten

Du kannst OAuth-Verbindungen im Neleto-Admin unter Profil -> Sicherheit -> Verbundene Anwendungen einsehen und widerrufen. Beim Widerruf werden die Access- und Refresh-Tokens der Anwendung sofort ungültig.

Konfiguration

Claude Code

Füge Neleto mit dem Befehl claude mcp add als Remote-HTTP-Server hinzu:

claude mcp add --transport http neleto https://your-neleto-instance.com/api/mcp \
  --header "Authorization: Bearer <your-token>"

Mit --scope user steht der Server in all deinen Projekten zur Verfügung statt nur im aktuellen. Prüfe die Verbindung mit claude mcp list und gib Claude dann eine Aufgabe für deine Website, zum Beispiel „Liste die Seiten meiner Neleto-Website auf".

VS Code (GitHub Copilot Agent Mode)

Erstelle oder aktualisiere .vscode/mcp.json in deinem Projekt:

{
    "servers": {
        "neleto": {
            "type": "http",
            "url": "https://deine-neleto-instanz.com/api/mcp",
            "headers": {
                "Authorization": "Bearer <dein-token>"
            }
        }
    }
}

Diese Konfiguration kannst du auch in deinen VS Code Benutzereinstellungen (JSON) unter dem mcp-Schlüssel eintragen, damit sie projektübergreifend gilt.

Claude Desktop

Claude Desktop unterstützt HTTP-MCP-Server nicht nativ, aber du kannst mcp-remote als Proxy verwenden. Füge folgendes zur Claude Desktop Konfigurationsdatei (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS) hinzu:

{
    "mcpServers": {
        "neleto": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://deine-neleto-instanz.com/api/mcp",
                "--header",
                "Authorization:Bearer <dein-token>"
            ]
        }
    }
}

Cursor

Öffne in Cursor Einstellungen -> Features -> MCP Servers und füge einen neuen Server hinzu:

{
    "neleto": {
        "type": "http",
        "url": "https://deine-neleto-instanz.com/api/mcp",
        "headers": {
            "Authorization": "Bearer <dein-token>"
        }
    }
}

OpenCode

Füge den Server in ~/.config/opencode/opencode.json unter dem mcp-Schlüssel hinzu:

{
    "mcp": {
        "neleto": {
            "type": "remote",
            "url": "https://deine-neleto-instanz.com/api/mcp",
            "headers": {
                "Authorization": "Bearer <dein-token>"
            }
        }
    }
}

Windsurf

Füge den Server in ~/.codeium/windsurf/mcp_config.json unter dem mcpServers-Schlüssel hinzu:

{
    "mcpServers": {
        "neleto": {
            "serverUrl": "https://deine-neleto-instanz.com/api/mcp",
            "headers": {
                "Authorization": "Bearer <dein-token>"
            }
        }
    }
}

Protokolldetails

Der MCP-Endpunkt verwendet JSON-RPC 2.0. Tool-Aufrufe verwenden die Methode tools/call:

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "page_list",
        "arguments": {
            "limit": 10
        }
    }
}

Eine vollständige Liste aller verfügbaren Tools findest du auf der Seite Tools-Referenz.