ContentsInhalt

MCP and AI toolsMCP und KI-Programme

Unterstützt Ihre KI-Plattform das Model Context Protocol (MCP), binden Sie die Polias-Suche ohne eigene Programmierung als Werkzeug ein: Adresse https://api.polias.eu/mcp (Transport „Streamable HTTP“), Kopf Authorization: Bearer <Ihr Schlüssel>. Das Werkzeug heißt suche und nimmt frage (Pflicht, höchstens 200 Zeichen), anzahl (1–10), start (0–90), sprache (de oder en, wie lang), land (de, at, ch), ort (Gemeinde, höchstens 80 Zeichen) und quelle (amtlich), mit derselben Bedeutung wie oben. Es liefert dieselben Treffer wie /v1/search, jede Suche über das kostenlose Kontingent hinaus zieht eine vom Guthaben ab, Grenzen und Fehler sind dieselben. Das Werkzeug reicht die Anfrage nur weiter und speichert nichts. Ohne sprache sucht es auf Deutsch; ort und quelle gibt es nur für Deutsch.

{
  "mcpServers": {
    "polias": {
      "url": "https://api.polias.eu/mcp",
      "headers": { "Authorization": "Bearer pol_IhrSchluessel" }
    }
  }
}

Die genaue Form der Einstellung hängt von Ihrer Plattform ab; nötig sind immer nur Adresse und Kopf.

In freien KI-Programmen einrichten

Ersetzen Sie jeweils pol_IhrSchluessel durch Ihren Schlüssel.

  • Open WebUI als Websuche: Adminbereich → Einstellungen → Websuche, Suchmaschine external, Adresse https://polias.eu/openwebui, API-Schlüssel: Ihr Schlüssel. Angaben hinter der Adresse gelten dann für alle Suchen, z. B. /openwebui?quelle=amtlich, /openwebui?land=at oder /openwebui?sprache=en (Englisch). Dieser Anschluss reicht die Suche wie das MCP-Werkzeug nur weiter und speichert nichts; Angaben zur Person, die Open WebUI mitschicken kann, werten wir nicht aus.
  • Open WebUI als Werkzeug (ab Version 0.6.31): Adminbereich → Einstellungen → Integrationen, „External Tool Servers“ → „Add Connection“, Typ „MCP (Streamable HTTP)“, Adresse https://api.polias.eu/mcp, Auth „Bearer“ mit Ihrem Schlüssel.
  • LibreChat (librechat.yaml, Schlüssel in der Umgebungsvariable POLIAS_KEY):
    mcpServers:
      polias:
        type: streamable-http
        url: https://api.polias.eu/mcp
        headers:
          Authorization: 'Bearer ${POLIAS_KEY}'
  • AnythingLLM (anythingllm_mcp_servers.json im Ordner plugins, danach in der MCP-Verwaltung neu laden):
    {
      "mcpServers": {
        "polias": {
          "type": "streamable",
          "url": "https://api.polias.eu/mcp",
          "headers": { "Authorization": "Bearer pol_IhrSchluessel" }
        }
      }
    }
  • n8n: am KI-Agenten den Baustein „MCP Client Tool“ anhängen, Adresse https://api.polias.eu/mcp, Übertragung „HTTP Streamable“, Anmeldung „Bearer“ mit Ihrem Schlüssel.
  • Dify: Werkzeuge → MCP → MCP-Server hinzufügen (HTTP), Adresse https://api.polias.eu/mcp, Kopf Authorization mit Bearer pol_IhrSchluessel.

If your AI platform supports the Model Context Protocol (MCP), add Polias search as a tool without writing code: URL https://api.polias.eu/mcp (transport "Streamable HTTP"), header Authorization: Bearer <your key>. The tool is called suche and takes frage (query, required, max. 200 characters), anzahl (1–10), start (0–90), sprache (de or en, like lang), land (de, at, ch), ort (municipality, max. 80 characters) and quelle (amtlich), meaning the same as above. It returns the same results as /v1/search; every search beyond the free allowance costs one search from your credit, limits and errors are the same. The tool only forwards the request and stores nothing. Without sprache it searches in German; ort and quelle are German only.

{
  "mcpServers": {
    "polias": {
      "url": "https://api.polias.eu/mcp",
      "headers": { "Authorization": "Bearer pol_yourkey" }
    }
  }
}

The exact form of the setting depends on your platform; all it ever needs is the URL and the header.

Setting it up in open AI tools

Replace pol_yourkey with your key in each case.

  • Open WebUI as web search: Admin Panel → Settings → Web Search, engine external, URL https://polias.eu/openwebui, API key: your key. Parameters added to the URL apply to all searches, e.g. /openwebui?quelle=amtlich, /openwebui?land=at or /openwebui?sprache=en (English). Like the MCP tool, this connector only forwards the search and stores nothing; personal details Open WebUI may send along are not used.
  • Open WebUI as a tool (version 0.6.31 or later): Admin Panel → Settings → Integrations, "External Tool Servers" → "Add Connection", type "MCP (Streamable HTTP)", URL https://api.polias.eu/mcp, auth "Bearer" with your key.
  • LibreChat (librechat.yaml, key in the environment variable POLIAS_KEY):
    mcpServers:
      polias:
        type: streamable-http
        url: https://api.polias.eu/mcp
        headers:
          Authorization: 'Bearer ${POLIAS_KEY}'
  • AnythingLLM (anythingllm_mcp_servers.json in the plugins folder, then reload in the MCP management):
    {
      "mcpServers": {
        "polias": {
          "type": "streamable",
          "url": "https://api.polias.eu/mcp",
          "headers": { "Authorization": "Bearer pol_yourkey" }
        }
      }
    }
  • n8n: attach the "MCP Client Tool" node to the AI agent, URL https://api.polias.eu/mcp, transport "HTTP Streamable", authentication "Bearer" with your key.
  • Dify: Tools → MCP → add MCP server (HTTP), URL https://api.polias.eu/mcp, header Authorization with Bearer pol_yourkey.