Ein Agent kann Capifold nutzen, um Werkzeuge und weitere Agenten zu finden, bevor du einen Anbieter verbindest. Die MCP-Anbindung von Capifold stellt Discovery-Operationen bereit: nach einer Aufgabe suchen, einen Kandidaten abrufen und dessen Herkunft prüfen.

Diese Anleitung verwendet das MCP-Konfigurationsformat von VS Code. Andere Clients können andere Schlüssel verlangen. Beginne mit der Verbindungsanleitung deiner Umgebung. Eine lokale Entwicklungsadresse funktioniert nicht für einen entfernten Nutzer.

1. Den tatsächlichen Endpunkt übernehmen

Öffne die Verbindungsanleitung und kopiere die Clientkonfiguration. Der öffentliche Discovery-Endpunkt benötigt kein Capifold-Konto und keinen API-Schlüssel. Ein gefundener Anbieter kann eigene, davon unabhängige Zugangsvoraussetzungen haben.

In VS Code trägst du die Konfiguration in .vscode/mcp.json ein. Die Grundstruktur lautet:

{
  "servers": {
    "capifold": {
      "type": "http",
      "url": "URL_AUS_DER_VERBINDUNGSANLEITUNG_EINTRAGEN"
    }
  }
}

Ersetze den Platzhalter vor der Verwendung. Trage keinen Anbieter-API-Schlüssel in dieses Beispiel ein. Die offizielle MCP-Anleitung von VS Code beschreibt Einrichtung und verfügbare Optionen. Die Projektdatei ist ein möglicher Ablageort und keine Aufforderung, Zugangsdaten ins Repository einzuchecken.

2. Eine Aufgabe oder einen exakten Produktnamen suchen

Lass deinen Client search_agents aufrufen. Die Argumente einer Suche können so aussehen:

{ "q": "document analysis", "limit": 5 }

Eine verbindliche Anforderung formulierst du ausdrücklich:

{
  "q": "document analysis",
  "limit": 5,
  "constraints": { "network": "none" }
}

Die Anforderung verschwindet nicht, wenn die Suche leer bleibt. Ein Kandidat mit unbekanntem Netzwerkverhalten belegt keinen Betrieb ohne Netzwerkzugriff. Entferne oder ändere eine Anforderung nur, wenn deine tatsächliche Aufgabe das erlaubt.

Beachte den zurückgegebenen Suchmodus und Hinweis. Bei einem lexikalischen Fallback werden Begriffe verglichen, weil semantisches Matching nicht verfügbar ist. Das bleibt ein Suchergebnis und ist kein erfolgreicher semantischer Test. Ein exakter Name hilft beim Finden eines bestimmten Produkts, hebt aber keine harten Anforderungen auf.

3. Einen Kandidaten abrufen und beurteilen

Übergib eine zurückgegebene ID an get_agent. Lies Originalmanifest, Fähigkeitenprofil, Quelle und Version. Über die öffentliche Profiladresse erhältst du die Ansicht für Menschen.

Prüfe die benötigte Operation, Ein- und Ausgabeformate, Transport, Zugriffsbedarf und vorhandene Nachweise mit ihrem jeweiligen Umfang. Fehlende Fakten bleiben unbekannt. Der Leitfaden zu Nachweisen erklärt die Unterschiede zwischen Anbieteraussage, Ableitung und Funktionstest.

4. Die Anbieteranbindung gesondert vorbereiten

Ein Profil kann deklarierte Dokumentation, eine Anbieterwebsite oder ein Quellcode-Repository verlinken. Enthält es einen vollständigen öffentlichen HTTP-MCP-Endpunkt, kann es eine Basiskonfiguration anbieten. Kläre die erforderlichen Zugangsdaten und Rechte vor der Verwendung beim Anbieter.

Ein reines Paketangebot, ein anderes Protokoll oder eine URL-Vorlage braucht andere Vorbereitungsschritte. Capifold erklärt diese Lücke, statt eine ausführbare Verbindung zu erfinden. Die Discovery-Operationen installieren oder starten die gefundenen Angebote nicht.

Fehler eingrenzen, ohne Anforderungen aufzuweichen

Kann der Client keine Verbindung herstellen, vergleiche die eingetragene URL mit der Verbindungsanleitung. Verwende den unterstützten HTTP-MCP-Transport; das Öffnen des Endpunkts als gewöhnliche Webseite ist kein Werkzeugaufruf. Prüfe Fehlermeldung und Konfigurationsformat deines Clients.

Funktioniert die Suche, aber kein Kandidat passt, prüfe Aufgabenbeschreibung und Anforderungen. Andere Begriffe können dieselbe Aufgabe verständlicher ausdrücken. Eine Datenschutz- oder Zugriffsgrenze darf dabei nicht stillschweigend entfallen. Für einen Pilotzugang nutze den Kontaktlink der Verbindungsanleitung und beschreibe die gewünschte Integration.