MCP-Server

Mit dem Model Context Protocol (MCP) verbindest du Poliscope direkt mit deinem KI-Chat. Statt alles selbst zu lesen und zu bewerten, fragst du in natürlicher Sprache, und Claude, ChatGPT oder ein anderes Modell ruft die passenden Poliscope-Werkzeuge auf, durchsucht Sitzungen und Dokumente und fasst die Ergebnisse für dich zusammen.

Beispiele für solche Fragen:

Welche Gemeinden im Landkreis Rosenheim haben in den letzten 30 Tagen über Photovoltaik-Freiflächenanlagen beraten? Wo gibt es freie Flächen oder Projektvorhaben ohne Projektentwickler?

Fasse mir die wichtigsten und größten Posten aus dem neuen Haushalt 2027 der Stadt Lüneburg zusammen.

Vergleiche, wie Augsburg und Regensburg mit dem Thema Bürgerbeteiligung bei Windkraft umgehen — gib mir Stichpunkte und die Quellen.

Was du damit tun kannst

• Trendbeobachtung — "Welche Themen rund um Verkehrswende waren 2026 in Hessen besonders präsent?"
• Konkurrenz-/Marktbeobachtung — "Wo wurden in den letzten 90 Tagen Glasfaserausbau-Vergaben behandelt?"
• Bedarfsrecherche für den Vertrieb — "Welche Kommunen sprechen gerade über die Beschaffung von IT-Infrastruktur?"
• Vorbereitung auf Termine — "Was hat der Stadtrat von Erlangen in den letzten 6 Monaten zum Thema Hochschulanbindung diskutiert?"
• Verwaltungseinheiten nachschlagen — "Welche Gemeinden gehören zum Landkreis Tirschenreuth? Gib mir die Links zu deren Ratsinformationssystemen."

Dokumente lesen und tiefer Recherchieren

Sobald in der Suche relevante Dokumente auftauchen, kann das Modell deren tatsächlichen Inhalt lesen und gezielt darin nach weiteren Begriffen, Aktenzeichen oder Paragrafen suchen. Deine Recherche kann mit Web-Ergebnissen oder anderen MCP-Servern weiter angereichert werden.

Such in den drei Vorlagen, die du gerade gefunden hast, nach dem Begriff '§35 BauGB' und gib mir die Fundstellen mit Seitenzahlen. Sag mir, welche Lokalzeitungen schon darüber berichten.

Voraussetzungen

• Ein Poliscope-Account mit aktivem Vertrag
• Einen API-Schlüssel (siehe nächster Abschnitt)
• Einen MCP-fähigen KI-Client — z. B. Claude.ai (Pro/Team), Claude Desktop, ChatGPT (Plus/Team mit Connectors), Cursor, Claude Code oder eine eigene Integration

API-Schlüssel erstellen

1. Logge dich in der Poliscope-Webapp ein
2. Öffne die API-Seite
3. Klicke auf Neuen Schlüssel generieren und kopiere den angezeigten Schlüssel
4. Bewahre den Schlüssel sicher auf (Passwort-Manager); behandle ihn wie ein Passwort

Verbinden

Claude.ai (Web, Pro/Team)

1. Öffne die Claude Konnektoren Einstellungen
2. Wähle "+ Benutzerdefinierten Connector hinzufügen"
3. Trage als URL ein: https://api.poliscope.de/v2/mcp/poliscope?access_token=DEIN_SCHLÜSSEL
4. Speichern — Poliscope steht ab sofort in jedem Chat als Werkzeug zur Verfügung

Eigene Integration

Der Endpunkt spricht HTTP-Streaming-Transport des Model Context Protocol. Jeder MCP-konforme Client funktioniert. Die offizielle Spezifikation: modelcontextprotocol.io.

Authentifizierung erfolgt über einen Bearer-Token (deinen API-Schlüssel) — entweder im Authorization-Header (Authorization: Bearer DEIN_SCHLÜSSEL) oder, falls dein Client das nicht unterstützt, als access_token-Query-Parameter.

Probleme & Troubleshooting

"Authentication required" oder 401 Dein API-Schlüssel fehlt oder ist falsch eingetragen. Prüfe in der Webapp unter Einstellungen → API, ob der Schlüssel korrekt ist. Achte darauf, dass kein Leerzeichen davor oder dahinter steht.

"No results for ..." Weise die KI an, allgemeiner zu suchen, einen weiteren Zeitraum zu wählen oder die räumliche Eingrenzung zu lockern. In Regionen ohne aktives Ratsinformationssystem gibt es naturgemäß keine Treffer — das Modell weist normalerweise selbst darauf hin.

"Dieses Dokument konnte nicht gelesen werden" Das Dokument wird gerade noch verarbeitet oder die automatische Texterkennung ist fehlgeschlagen. Bei laufender Verarbeitung in ein paar Minuten erneut versuchen — bei dauerhaftem Fehlschlag schreib uns kurz, dann schauen wir uns das konkrete Dokument an.

Das Modell wählt das falsche Werkzeug oder versteht den Auftrag falsch Sei expliziter: "Such erst die Sitzung, dann hol die Vorlage" statt "Sag mir alles dazu". Wenn das nicht hilft, freuen wir uns über dein Feedback.

Die Verbindung hängt oder bricht ab Schau, ob die Status-Seite Auffälligkeiten meldet, und versuche es in ein paar Minuten erneut. Wenn das Problem bleibt: melde dich.