MCP-Tools-Referenz
Wie Ihre KI die SpecMCP-Tools nutzt, um Zulassungs- und Spezifikationsfragen zu beantworten.
SpecMCP ist ein einzelner gehosteter MCP-Server. Ihr KI-Client erkennt dessen Tools, sobald Sie mit https://mcp.specmcp.com/mcp verbunden sind. In der Regel beschreiben Sie das gewünschte Ergebnis, und der Assistent wählt die passenden Aufrufe. Am besten gelingt das, wenn Sie den Produkt- oder Anbieterkontext nennen und den Assistenten bitten, seinen Umfang offenzulegen.
Beschreiben Sie das Ziel, nicht den Tool-Aufruf
Fragen Sie nach dem Zulassungssteckbrief, der Umsetzungs-Prüfliste oder der Release-Auswirkung, die Sie brauchen. Die Tools von SpecMCP sind darauf ausgelegt, dass Ihre KI sie zum passenden Ablauf zusammensetzt.
Den passenden Ablauf wählen
| Ihre Frage | Beginnen mit | Warum |
|---|---|---|
| „Was müssen wir zulassen?“ | list_scopes | Zulassungspflichten ergeben sich aus einem Zulassungssteckbrief. |
| „Welche Anforderungen gelten für diese Funktion?“ | list_specs | Zuerst die Spezifikationen bestimmen, die die Funktion regeln. |
| „Was bedeutet A_22793-01?“ | get_requirement | Eine bekannte ID lässt sich direkt abrufen. |
| „Was hat sich in diesem Release geändert?“ | get_spec_version_history | Liefert die exakten Versionsnamen für einen Vergleich. |
Tools für Zulassungssteckbriefe
list_scopes
Listet die verfügbaren Zulassungsprogramme und ihre aktuellen Versionen auf. Optional lässt sich nach gemProdT (Produkttyp) oder gemAnbT (Anbietertyp) filtern. Nutzen Sie es, bevor Sie fragen, welcher Zulassungssteckbrief gilt.
Liefert: je Zulassungssteckbrief Slug, Name, Typ, Beschreibung, aktuelle Version und verfügbare Versionen.
Liste die Zulassungssteckbriefe auf, die für unseren TI-Messenger-Client infrage kommen. Erläutere die Kandidaten, bevor du einen auswählst.list_scope_specs
Nimmt einen scope_slug aus list_scopes und liefert die exakten Spezifikationsversionen, die dieser Zulassungssteckbrief abdeckt. Nutzen Sie es, wenn Sie den Quellkontext des Zulassungssteckbriefs brauchen, nicht die vollständige Prüfliste.
Nutze nach dem Auflisten der Kandidaten den Slug des gewählten Zulassungssteckbriefs, um seine abgedeckten Spezifikationen aufzulisten, und erläutere, welche für den Betrieb des Dienstes relevant sind.list_scope_requirements
Nimmt einen scope_slug und liefert alle Anforderungen, die die gematik für diesen Zulassungssteckbrief aktiv prüft. Die Ergebnisse enthalten Anforderungs-ID, Titel, Schweregrad, Quellspezifikation, Prüfverfahren und Prüfgruppe. Optionale Filter: verification_group und table (ptv, atv oder beide).
Nutzen Sie dies für die Zulassungsplanung. Es ist die maßgebliche Prüfliste des Zulassungssteckbriefs; Anforderungen aus einer referenzierten Spezifikation, die hier fehlen, sind für diesen Zulassungssteckbrief nicht prüfrelevant.
Hole für den gewählten Zulassungssteckbrief die vollständige Prüfliste. Gruppiere sie nach Prüfverfahren und hebe jede must- oder must_not-Anforderung hervor.diff_scope_versions
Vergleicht zwei Versionen eines Zulassungssteckbriefs. Erfordert scope_slug und from_version; to_version ist standardmäßig die neueste. Setzen Sie include_content: true, wenn Sie den vollständigen Text der geänderten Anforderungen für eine Migrationsbewertung brauchen.
Vergleiche die vorherige und die neueste Version dieses Zulassungssteckbriefs. Zeige hinzugefügte, entfernte und geänderte Anforderungen, mit vollständigem Text für die geänderten.Tools für Spezifikationen und Anforderungen
list_specs
Listet die verfügbaren Spezifikationen nach Kategorie auf, samt Angabe, was jede Spezifikation regelt, für wen sie gilt, welche Kernthemen sie hat, welche Version aktuell ist und welche Entwurfsversionen bekannt sind. Es gibt keine Eingaben.
Nutzen Sie es, um vor der Anforderungssuche eine belastbare Suchgrenze zu setzen.
Liste die aktuellen Spezifikationen auf, die für die Authentifizierung in einem TI-Messenger-Client relevant sind. Gib an, welche du durchsuchen wirst und warum.search_requirements
Führt eine semantische Suche innerhalb ausdrücklich angegebener spec_ids durch. Erfordert eine query und die Spezifikations-IDs aus list_specs; optionale Steuerungen sind limit, severity und include_drafts.
Liefert: gerankte Treffer mit ID, Titel, Schweregrad, Quellspezifikation und -version sowie Ähnlichkeit, jedoch nicht den vollständigen Anforderungstext. Rufen Sie danach mit get_requirement oder get_requirements die Anforderungen ab, die Sie auslegen müssen.
Prop
Type
Durchsuche die eingegrenzten Spezifikationen nach Authentifizierungsanforderungen. Beschränke auf must und must_not und rufe dann das vollständige Detail der zehn relevantesten Treffer ab.get_requirement
Ruft das vollständige Detail einer Anforderung ab. Geben Sie entweder die von der Suche gelieferte UUID oder eine gematik-requirement_id an, etwa A_22793-01 oder GS-A_4657. Sie können eine bekannte ID auch auf eine bestimmte version festlegen.
Standardmäßig löst eine wiederholte ID auf die gültige Version auf. Fordern Sie eine Entwurfsversion nur ausdrücklich an, wenn Sie eine kommende Änderung bewerten; Entwurfsergebnisse sind als nicht verbindlich gekennzeichnet.
get_requirements
Ruft das vollständige Detail für mehrere Anforderungs-IDs ab. Nutzen Sie es nach einer Suche, wenn mehrere Ergebnisse gemeinsam zu prüfen sind. Geben Sie requirement_ids an; optional version, um eine bestimmte Version abzurufen.
Rufe die vollständigen Details dieser Anforderungs-IDs ab und mach daraus eine Umsetzungs-Prüfliste. Behalte IDs, Schweregrad, Quellspezifikation und Querverweise bei.list_requirements
Liefert alle Anforderungen einer spec_id, nicht nur die besten semantischen Treffer. Nutzen Sie es, wenn Vollständigkeit für eine bestimmte Spezifikation zählt. Sie können nach severity filtern und eine bestimmte version wählen.
Das kann ein großes Ergebnis erzeugen. Bitten Sie zuerst um eine Zusammenfassung oder einen Schweregrad-Filter, sofern Sie nicht wirklich die vollständige Liste brauchen.
Versions-Tools
get_spec_version_history
Listet die bekannten Versionen und Release-Angaben einer spec_id auf. Nutzen Sie es vor einem Versionsvergleich und um exakte Entwurfsversionsnamen zu ermitteln.
diff_versions
Vergleicht zwei Versionen einer Spezifikation. Geben Sie spec_id an; ohne weitere Angabe ist from_version die vorherige und to_version die aktuelle Version. Es unterscheidet hinzugefügte, entfernte und geänderte Anforderungen, einschließlich der von der gematik überarbeiteten -NN-Anforderungs-IDs. Setzen Sie include_content: true für den vollständigen geänderten Text.
Zeige die Versionshistorie von gemSpec_TI-Messenger-Client und vergleiche dann die aktuelle Version mit der vorherigen. Nimm den vollständigen Inhalt für verpflichtende Änderungen auf und schlage Migrationsaufgaben vor.Verlässliche Prompts
- Nennen Sie Produkt, Anbieter, Funktion und bekannten Zulassungssteckbrief oder bekannte Spezifikation.
- Lassen Sie den Assistenten angeben, welche Zulassungssteckbriefe und Spezifikationen er durchsucht und welche er ausgeschlossen hat.
- Lassen Sie ihn verbindliche aktuelle Anforderungen von Entwürfen trennen.
- Ziehen Sie für eine Zulassungsentscheidung die Prüfliste des Zulassungssteckbriefs einer breiten semantischen Suche vor.
- Behalten Sie Anforderungs-IDs und Quellspezifikationen in jedem Ticket, jeder Prüfliste und jeder Prüfnotiz bei, die der Assistent erstellt.