Installation

MCP-Server installieren

Kein Download nötig. Melde dich in deinem Client an oder richte ihn mit der Server-URL und einem API-Schlüssel ein.

Den Assistenten einrichten lassen

Füge diesen Prompt in Claude Code, Cursor oder einen anderen Assistenten ein, der eine URL lesen und Befehle ausführen kann. Der Assistent folgt der Installationsanleitung, fragt nach deinem Schlüssel und installiert den Skill.

1Lies https://docs.gunspec.io/mcp/install.md2und richte den GunSpec-MCP-Server für mich ein.3Frag mich nach meinem API-Schlüssel.

Datei	Was es ist
`install.md`	Die Installationsanleitung, der der Assistent folgt.
`SKILL.md`	Ein Agent Skill, der einem Assistenten vorgibt, welches Tool er verwendet und wie er die Ergebnisse auswertet.
`tools.md`	Jedes Tool mit seinen Argumenten.
`tools.json`	Jedes Tool mit Plan, API-Operation und Beispielargumenten im JSON-Format.

1. Verbindungsart wählen

Beide erreichen dieselben Tools im selben Tarif. Melde dich an, wenn dein Client es unterstützt; nutze einen Schlüssel für Skripte und für Clients, die keinen Browser öffnen können.

Anmelden

1https://mcp.gunspec.io/mcp-oauth

Dein Client öffnet einen Browser, du bestätigst in deinem Konto, und die Verbindung steht. Kein Schlüssel zum Erstellen, Kopieren oder Rotieren, und du kannst die Verbindung jederzeit in deinem Konto trennen. So funktioniert die Anmeldung.

2. Server zum Client hinzufügen

Wähle deinen Client. Jeder fügt den Server nur über seine URL hinzu und fragt beim ersten Verbinden nach der Anmeldung.

Claude Code

1claude mcp add --transport http gunspec https://mcp.gunspec.io/mcp-oauth2claude mcp login gunspec

claude mcp login öffnet den Browser; in einer Sitzung macht /mcp dasselbe. Mit --scope user im ersten Befehl steht der Server in jedem Projekt zur Verfügung.

Aus dem MCP Registry installieren

Der Server ist im offiziellen MCP Registry als io.gunspec/mcp gelistet. Clients, die das Registry durchsuchen, können ihn von dort hinzufügen: Der Eintrag nennt die Server-URL, den Transport und einen erforderlichen, als geheim markierten X-API-Key-Header, sodass der Client nach Ihrem API-Schlüssel fragt, statt ihn im Eintrag zu speichern. Nur der Inhaber der Domain gunspec.io kann unter diesem Namen veröffentlichen; ein Eintrag mit diesem Namen ist daher der offizielle Server.

1curl -s "https://registry.modelcontextprotocol.io/v0/servers/io.gunspec%2Fmcp/versions"

Der Eintrag dient nur dem Auffinden. Er gewährt keinen Zugriff: Jeder Aufruf benötigt weiterhin einen gültigen API-Schlüssel, und Ihr Tarif, Ihr Ratenlimit und Ihr MCP-Kontingent gelten weiter. Jede Version des Servers wird nach ihrer Bereitstellung gelistet.

Eintrag wird aus dem Registry gelesen…

Für MCP-Verzeichnisse und -Kataloge

Eine Aufnahme dieses Servers ist willkommen. Jede Anfrage benötigt einen Schlüssel, auch tools/list; eine Statusprüfung oder Tool-Erkennung ohne Schlüssel wird mit 401 beantwortet, und der Eintrag meldet den Server als nicht verfügbar.

Dafür stellen wir Schlüssel aus, die auf diesen Server beschränkt sind. Server listen erklärt, was ein solcher Schlüssel kann, und zeigt die nächtlichen Prüfungen, die das belegen.

Leitfaden für Verzeichnisse

3. Verbindung prüfen

Stelle deinem Assistenten eine Frage, die nur der Katalog beantworten kann. Zum Beispiel:

1Finde mit GunSpec die Glock 19 und nenne mir Lauflänge und Gewicht.

Der Assistent sollte gunspec_identify_firearm aufrufen. Dieses Tool löst den Namen auf und liest den Datensatz in einem einzigen Aufruf. Das Nachschlagen einer Waffe über ihren Namen erfordert den Builder-Plan. Mit Explorer frage stattdessen: "Liste mit GunSpec die Pistolen von Glock auf", was gunspec_list_firearms aufruft. Meldet der Assistent, dass ein Tool einen höheren Plan erfordert, funktioniert die Verbindung, aber dein Plan umfasst dieses Tool nicht. Siehe Nutzung und Limits.