Plugins, die nur auf dem Desktop laufen, müssen lokal auf dem Computer der jeweiligen Person ausgeführt werden. Dazu gehören die meisten Plugins mit einem lokalen MCP-Server (stdio) sowie Plugins, die lokale Programme aufrufen. Im OpenAI Plugin Directory tragen sie die Kennzeichnung Nur Desktop. Du kannst sie nur über die Desktop-App von ChatGPT installieren und nur in Threads erwähnen, die lokal ausgeführt werden.
Genehmigung erforderlich: Nur zugelassene Partnerorganisationen dürfen Plugins mit einem lokalen MCP-Server einreichen. Lass dir von deiner Ansprechperson bei OpenAI bestätigen, dass deine Organisation die Voraussetzungen erfüllt. Bitte sie, die einreichende Organisation für solche Einreichungen freischalten zu lassen, bevor du die folgenden Schritte ausführst.
Erstelle vor der Einreichung ein Paket für dein Plugin. Teste die Installation auf dem Desktop ohne vorhandene Version des Plugins und prüfe die wichtigsten Abläufe. Erfülle die üblichen Voraussetzungen für die Einreichung. Dazu gehören die Berechtigung zur Einreichung und die Überprüfung deiner Identität als entwickelnde Person oder der Identität deines Unternehmens.
Einen lokalen MCP-Server konfigurieren
Verwende dieselbe Plugin-Struktur wie bei anderen Plugins. Öffne mcp.json im Stammverzeichnis und ersetze unter mcpServers den Eintrag für den HTTP-Server durch einen stdio-Eintrag, der den Befehl für den lokalen Start des Servers festlegt.
Für den Server kannst du jede Programmiersprache oder Laufzeitumgebung verwenden, die MCP über stdio unterstützt. So könnte ein Eintrag für einen Node.js-Server aussehen:
{
"type": "stdio",
"command": "node",
"args": ["${PLUGIN_ROOT}/server/dist/index.js"],
"cwd": "${PLUGIN_ROOT}"
}
Nimm den Server und seine Abhängigkeiten in das Paket auf. ${PLUGIN_ROOT} ist ein integrierter Platzhalter.
Ein Plugin mit einem lokalen MCP-Server einreichen
- Die ID der Organisation, die das Plugin einreicht, findest du in den Organisationseinstellungen auf der OpenAI-Plattform.
- Schicke die ID an deine Ansprechperson bei OpenAI und bitte sie, deine Organisation für die Einreichung von Plugins mit einem lokalen MCP-Server freischalten zu lassen. Warte mit der Einreichung, bis du die Bestätigung erhalten hast.
- Öffne das Portal zur Einreichung von Plugins. Wähle Plugin erstellen und dann Nur Skills. Lade über ZIP-Datei hochladen dein Plugin-Paket einschließlich der lokalen MCP-Konfiguration hoch.
- Erfülle die Anforderungen für die Einreichung und reiche dein Plugin zur Prüfung ein. Veröffentliche es nach der Genehmigung über das Portal.
Plugins ohne MCP-Server
Wenn dein Plugin ausschließlich Skills enthält und auf dem Desktop ausgeführt werden muss, setze requires_local_executor auf true. Der Eintrag gehört in den Abschnitt extensions.com.openai der Datei plugin.json im Stammverzeichnis:
{
"extensions": {
"com.openai": {
"requires_local_executor": true
}
}
}
Bei einem älteren Paket, das .codex-plugin/plugin.json verwendet, füge "requires_local_executor": true stattdessen auf der obersten Ebene dieses Manifests hinzu.
Mit dieser Einstellung erhält dein Plugin die Kennzeichnung Nur Desktop. Folge den üblichen Schritten zur Einreichung. Wenn das Portal meldet, dass das Feld nicht zulässig ist, schicke die ID der einreichenden Organisation an deine Ansprechperson bei OpenAI. Lass dir bestätigen, dass die Organisation zur Einreichung berechtigt ist.