Plugins-API
Erfasse und verwalte die Plugins in deiner Claude Enterprise-Organisation: Lade Plugins und Versionen hoch, wähle die Version, die Mitgliedern bereitgestellt wird, lege fest, wer welches Plugin nutzen kann, lade Plugin-Dateien zur Prüfung herunter und validiere einen Marketplace, bevor du ihn verbindest.
Mit der Plugins-API kannst du jedes Plugin in deiner Claude Enterprise-Organisation erfassen, Plugins und neue Versionen aus deinen eigenen Pipelines veröffentlichen, festlegen, welche Version Mitgliedern bereitgestellt wird, bestimmen, wer welches Plugin nutzen kann, Plugin-Dateien zur Prüfung herunterladen und einen Git-Marketplace prüfen, bevor du ihn verbindest.
Berichte zur Nutzung von Plugins (welche Plugins und Skills Mitglieder nutzen und wie oft) findest du unter Analytics-APIs.
Endpunkte
Die API stellt 18 Endpunkte für fünf Ressourcen bereit:
| Ressource | Endpunkte |
|---|---|
| Plugins: alle Plugins der Organisation auflisten, ein neues hochladen, eines abrufen, die Version wählen, die Mitgliedern bereitgestellt wird (Rollback oder Promotion), eines löschen | GET /v1/organizations/pluginsPOST /v1/organizations/pluginsGET /v1/organizations/plugins/{plugin_id}POST /v1/organizations/plugins/{plugin_id}DELETE /v1/organizations/plugins/{plugin_id} |
| Plugin-Versionen: den Versionsverlauf eines Plugins auflisten, eine neue Version hochladen, eine abrufen, die Dateien einer Version herunterladen | GET /v1/organizations/plugins/{plugin_id}/versionsPOST /v1/organizations/plugins/{plugin_id}/versionsGET /v1/organizations/plugins/{plugin_id}/versions/{version}GET /v1/organizations/plugins/{plugin_id}/versions/{version}/content |
| Installationseinstellungen: lesen, wer ein organisationseigenes Plugin nutzen kann, dies für die gesamte Organisation oder für eine Gruppe festlegen, eine der beiden Einstellungen entfernen | GET /v1/organizations/plugins/{plugin_id}/installation_settingsPOST /v1/organizations/plugins/{plugin_id}/installation_settings/{target}DELETE /v1/organizations/plugins/{plugin_id}/installation_settings/{target} |
| Freigaben: lesen, mit wem ein Mitglied sein eigenes Plugin geteilt hat (nur lesend) | GET /v1/organizations/plugins/{plugin_id}/shares |
| Plugin-Marketplaces: die ID eines Marketplace finden, einen abrufen, die Standard-Installationseinstellung für seine Plugins festlegen, Marketplace-Inhalte vor dem Verbinden prüfen | GET /v1/organizations/plugin_marketplacesGET /v1/organizations/plugin_marketplaces/{marketplace_id}POST /v1/organizations/plugin_marketplaces/{marketplace_id}POST /v1/organizations/plugin_marketplaces/validate_repositoryPOST /v1/organizations/plugin_marketplaces/validate_archive |
Dieses Release umfasst keine eigenständigen Skills (Skills, die ein Mitglied im Skills-Editor schreibt oder als einzelnen Skill in claude.ai hochlädt). Sie erscheinen nicht im Bestand und können hier nicht erstellt werden. Plugins, die Anthropic veröffentlicht, werden ebenfalls nicht erfasst; ihre Nutzung wird von den Analytics-APIs gemeldet. Marketplaces werden in claude.ai erstellt, mit Repositories verbunden und gelöscht, nicht über diese API.
Voraussetzungen
- Deine Organisation muss einen Claude Enterprise-Plan haben.
- Dein Primary Owner erstellt unter claude.ai > Organisationseinstellungen > API einen Admin-API-Key mit dem Scope
read:plugins, dem Scopewrite:pluginsoder beiden. Siehe Admin-API-Key erstellen. - Jede Anfrage enthält drei Header:
x-api-key,anthropic-version: 2023-06-01undanthropic-beta: ce-plugins-2026-09-01.
Die SDKs für Python, TypeScript, C#, Go, Java, PHP und Ruby stellen diese Endpunkte unter client.beta.organization bereit und die ant CLI unter ant beta:organization; sie senden die Header anthropic-version und anthropic-beta für dich. Die Beispiele auf dieser Seite verwenden den Standard-Client jedes SDK, der, wie die CLI, den Admin-API-Key aus der Umgebungsvariable ANTHROPIC_API_KEY liest; die curl-Beispiele lesen den Key aus derselben Variable und übergeben ihn im Header x-api-key. Wenn ein SDK oder die CLI weitere Seiten für dich abruft, legt limit die Seitengröße fest, nicht die Gesamtzahl (siehe Paginierung).
API-Keys gehören der Organisation und funktionieren weiter, nachdem die Person, die sie erstellt hat, die Organisation verlässt. Teile sie nicht und checke sie nicht in die Versionskontrolle ein.
Schnellstart
Liste die Plugins in den eigenen Marketplaces deiner Organisation auf, die neuesten zuerst:
client = anthropic.Anthropic()
plugins = client.beta.organization.plugins.list(owner_type="organization", limit=20)
# Ruft bei Bedarf automatisch weitere Seiten ab.
for plugin in plugins:
print(f"{plugin.id}: {plugin.name}"){
"data": [
{
"type": "plugin",
"id": "plugin_01Hq3vX8kZcN2mB7pR4tY9wL",
"name": "sales-toolkit",
"display_name": "Sales Toolkit",
"description": "Account research and call prep for the sales team.",
"served_version_id": "pluginver_01Km7tL4pR9xF5sU2zV3jP6q",
"served_version_pinned": true,
"latest_version_id": "pluginver_01Jd5sK2nQ8wE4rT6yU1iO3p",
"manifest_version": "1.4.0",
"owner": { "type": "organization" },
"marketplace_id": "marketplace_01Lp8uM5qS1yG6tV3aW4kQ7r",
"created_by": { "type": "api_actor", "api_key_id": "apikey_01Nq9vN6rT2zH7uW4bX5mR8s" },
"organization_installation_preference": "available",
"organization_installation_preference_inherited": true,
"content_scan": { "status": "completed", "assessment": "pass", "reason": null },
"components": [
{
"type": "skill",
"name": "account-research",
"description": "Researches a customer account before a call."
},
{ "type": "mcp_server", "name": "crm",