Codex plugins: wat ze zijn, welke er zijn en hoe je ze installeert

Definitie

Wat is een Codex plugin? Een pakket, geen losse functie

OpenAI omschrijft plugins als bundels die mogelijkheden verpakken tot herbruikbare workflows in ChatGPT en Codex. Een plugin kan vier soorten onderdelen bevatten. ChatGPT en Codex delen één universele plugin directory: wat je in de een vindt, vind je ook in de ander. Een losse werkwijze zonder koppeling is een skill; die leg je vast in een SKILL.md, zie Codex skills.

Wat je in de praktijk tegenkomt: een koppeling of een werkwijze

In de officiële plugins zie je vooral twee vormen. De eerste is een koppeling: een verwijzing naar een geregistreerde connector, zoals bij Teams, SharePoint, Outlook en Gmail. De tweede is een pakket skills, soms met een eigen MCP-server, zoals bij Vercel of Superpowers. Dat verschil bepaalt wat je krijgt. Een koppelingsplugin geeft Codex toegang tot je data, maar weet niet hoe jullie werken. Die werkwijze schrijf je zelf, als skill.

Waarom OpenAI met plugins werkt in plaats van losse instellingen

Zonder plugin stel je drie dingen apart in: een MCP-server, de inlog en de instructies. Met een plugin installeer je dat in één klik, met één versie. Voor een team betekent dat: iedereen werkt met dezelfde koppeling en dezelfde instructies, en een update komt bij iedereen tegelijk aan. Plugins zijn dus vooral een manier van verspreiden. Wie alleen voor zichzelf één server aanhangt, heeft genoeg aan een MCP-regel in config.toml.

Beschikbaarheid

Waar werken Codex plugins, en wat kosten ze?

Plugins werken niet overal waar Codex draait. De IDE-extensie is de grote uitzondering: daar worden plugins niet ondersteund, wel MCP-servers. Werk je vooral in VS Code of Cursor, dan is de MCP-route jouw route.

Welk abonnement heb je nodig?

De directory is zichtbaar op alle ChatGPT-plannen. Of je een plugin mag installeren en gebruiken, hangt volgens het Help Center af van je plan, de instellingen van je werkruimte, je rol, het oppervlak, je regio en de apps in de plugin. Een vaste tabel per plan publiceert OpenAI niet. Bij Free en Go zit Codex in de desktop-app; wat je daar gratis wel en niet kunt, staat op is Codex gratis.

Kosten: geen pluginprijs, wel verbruik

De documentatie noemt geen aparte prijs voor plugins. Wat je wel betaalt, is het werk dat een plugin veroorzaakt: elke toolaanroep en elke lap tekst die een koppeling ophaalt, gaat af van dezelfde Codex-limiet als de rest van je werk. OpenAI noemt minder MCP-servers zelf als manier om verbruik te drukken. Soms heb je ook een abonnement bij de dienst zelf nodig, bijvoorbeeld een betaald Notion- of Linear-account. Hoe de limieten werken en wat Plus, Pro en Business kosten, staat op wat kost Codex.

Met een API-key in plaats van een ChatGPT-login

Log je in met een OpenAI API-key, dan kun je alleen ondersteunde, door OpenAI gecureerde plugins installeren, in de CLI en de desktop-app. Sommige plugins vallen af, omdat hun inlogflow OAuth-mogelijkheden vraagt die met een API-key niet werken. Het verbruik zie je dan op de Usage-pagina van het OpenAI Platform. Welke plugins precies afvallen, zie je in de catalogustabel. Het verschil tussen de twee manieren van inloggen staat op Codex inloggen.

Catalogus

Welke Codex plugins zijn er? De officiële catalogus, geteld

De officiële set heet openai-curated, met de weergavenaam Codex official. Het marketplacebestand op github.com/openai/plugins telde op 30 oktober 2026 65 plugins. Voor wie met een API-key inlogt, bestaat een tweede bestand, openai-api-curated, met 50 plugins. De universele directory in ChatGPT kan meer tonen, omdat partners er via het inzendportaal plugins aan toevoegen en je werkruimte eigen plugins kan leveren; een totaal daarvan publiceert OpenAI niet.

Wat er in die 65 zit

We hebben de git-tree van openai/plugins op 30 oktober 2026 doorgeteld. 36 plugins wijzen naar een geregistreerde connector, 31 hebben een eigen MCP-configuratie en 46 hebben een skills-map, met samen 535 SKILL.md-bestanden. 23 plugins zijn alleen skills. Geen enkele officiële plugin levert hooks mee. De categorieën: Developer Tools (27), Productivity (12), Creativity (9), Communication (5), Education & Research (4), Data & Analytics (3), Finance (2) en vier categorieën met één plugin.

Let op: de Microsoft- en Google-plugins zijn kale koppelingen

In de plugins voor Outlook, Teams, Gmail en Slack zat op 30 oktober 2026 geen enkele skill, alleen de koppeling. Ze geven Codex toegang tot je mail of kanalen, maar geen werkwijze. Dat wijkt af van wat oudere overzichten laten zien, ook onze eigen telling van 1 augustus op Codex skills. Wil je dat Codex een klantmail in jullie toon opstelt, dan schrijf je die werkwijze zelf als skill.

De catalogus krimpt en verandert

Op 1 augustus 2026 telde hetzelfde bestand nog 180 plugins; op 30 oktober 65. HubSpot en Netlify staan er bijvoorbeeld niet meer in. Bouw dus geen werkproces op een plugin zonder te controleren of hij er nog is. Met codex plugin list --available --json zie je in de CLI wat je marketplaces op dit moment aanbieden.

Installeren

Codex plugins installeren in de CLI en de desktop-app

In de Codex CLI staat de functie plugins sinds versie 0.166.0 (29 oktober 2026) als stabiel en standaard aan; je hoeft geen feature-flag meer te zetten. De officiële catalogus openai-curated hoef je niet toe te voegen: die beheert Codex zelf. Alle commando's uit de CLI-referentie:

Verwijderen laat de koppeling staan

Met Uninstall plugin haal je het pakket weg, maar een MCP-koppeling die je in ChatGPT hebt verbonden, blijft actief tot je die daar zelf verbreekt. Ruim je op omdat iemand vertrekt of een tool niet meer gebruikt wordt, loop dan ook de verbonden apps in ChatGPT na. Plugins die je werkruimte installeert, kun je soms niet zelf verwijderen: die beheert je admin.

npx codex-marketplace is geen OpenAI-commando

Zoek je op "codex plugin", dan noemt het AI-overzicht van Google een commando als npx codex-marketplace add. Dat hoort bij een website van derden, niet bij OpenAI. Het officiële pad is codex plugin marketplace add en codex plugin add. Wie van Claude Code of Cursor komt: /import in de Codex CLI haalt je instructies, MCP-servers, plugins en recente chats daaruit binnen.

MCP

Codex MCP: een server los toevoegen in config.toml

Heeft je systeem geen plugin, dan koppel je het met een MCP-server. De desktop-app, de CLI en de IDE-extensie delen dezelfde MCP-configuratie in ~/.codex/config.toml; per project kan het in .codex/config.toml, maar alleen in vertrouwde projecten. ChatGPT op het web leest die bestanden niet en gebruikt MCP alleen via plugins. Wat MCP precies is, staat in het woordenboek.

Zo ziet het eruit in config.toml

Een lokale server met goedkeuring voor elke schrijfactie:

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
default_tools_approval_mode = "writes"
startup_timeout_sec = 20

Een server op een adres, met een token uit een omgevingsvariabele:

[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"

Zet tokens nooit letterlijk in config.toml. Een omgevingsvariabele houdt ze buiten je repo en buiten schermdelingen.

De vier instellingen die je echt gebruikt

default_tools_approval_mode kent auto, prompt, writes en approve. Kies writes: Codex vraagt dan toestemming bij elke tool die niet als alleen-lezen is gemarkeerd, en leest zonder te vragen. enabled_tools en disabled_tools beperken welke tools de server mag aanbieden; minder tools betekent minder context en minder kans dat Codex de verkeerde pakt. enabled = false zet een server tijdelijk uit zonder hem te verwijderen. De timeouts staan standaard op 10 seconden voor opstarten en 60 voor een toolaanroep; verhoog startup_timeout_sec als een npx-server bij de eerste start te traag is.

In de desktop-app en de IDE-extensie

In de desktop-app: Settings, MCP servers, Add server. Kies STDIO of Streamable HTTP, vul het commando of de URL in, sla op en klik Restart. In de IDE-extensie: tandwielmenu, MCP servers, Add server, en daarna Restart extension. Omdat de configuratie gedeeld is, staat een server die je in de CLI toevoegt ook in de app.

MCP-servers die in een plugin zitten

Een plugin start zijn eigen servers, dus het commando bepaal jij niet. Aan/uit en toolbeleid wel:

[plugins."naam@marketplace".mcp_servers.servernaam]
enabled = true
default_tools_approval_mode = "prompt"
enabled_tools = ["read", "search"]

Zelf een server bouwen voor je eigen systeem? Begin bij een MCP-server maken.

Beslisregel

Plugin, MCP-server of skill: welke kies je?

De vraag die we in trainingen het vaakst krijgen. De regel: neem het lichtste middel dat de klus betrouwbaar klaart. Een skill vraagt geen rechten, een MCP-server wel, een plugin bundelt beide en is vooral handig om te verspreiden.

Een vuistregel voor het aantal

Begin met hooguit twee plugins of MCP-servers: de systemen waar je werk elke dag echt in zit. Pas na een week zie je welke Codex daadwerkelijk aanroept. Wat hij niet aanroept, zet je uit. Dezelfde afweging voor ChatGPT zelf staat op ChatGPT plugins en skills, en hoe Claude Code dezelfde bouwstenen gebruikt op Claude Code vs Codex.

Zelf bouwen

Zelf een Codex plugin maken en met je team delen

Een eigen plugin is de nette manier om skills, een MCP-server en instellingen als één pakket bij collega's te krijgen. Je hoeft het manifest niet uit je hoofd te kennen: de ingebouwde skill Plugin Creator maakt het voor je.

Een marketplace.json om te kopiëren

{
"name": "bedrijf-plugins",
"interface": { "displayName": "Bedrijfsplugins" },
"plugins": [
{
"name": "offerte-opvolging",
"source": { "source": "local", "path": "./plugins/offerte-opvolging" },
"policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" },
"category": "Productivity"
}
]
}

Het pad begint met ./ en blijft binnen de root van de marketplace. AVAILABLE betekent: collega's mogen hem installeren. INSTALLED_BY_DEFAULT zet hem bij iedereen klaar, NOT_AVAILABLE verbergt hem.

Het minimale manifest

{
"name": "offerte-opvolging",
"version": "0.1.0",
"description": "Skills voor offerte-opvolging en klantmails in Nederlandse zakelijke toon.",
"skills": "./skills/"
}

De name is kebab-case en wordt de naamruimte van de plugin. Verhoog version bij elke wijziging, zodat je in de cache ziet welke versie draait. OpenAI beschrijft daarnaast een draagbare opzet met plugin.json in de root en een $schema van agent-plugins.org; de Plugin Creator maakt de opzet met .codex-plugin/.

Publiek aanbieden is een aparte route

Lokale en repo-marketplaces zijn voor jezelf en je team. Wil je een plugin in de universele directory, dan dien je hem in via het inzendportaal van OpenAI. Plugins met hooks komen niet in aanmerking voor de publieke directory.

Beheer

Plugins beheren voor Business en Enterprise

Voor een admin zijn er twee knoppenborden. In de ChatGPT-werkruimte bepaal je welke plugins je team ziet en krijgt. In requirements.toml dwing je af wat de Codex desktop-app en de CLI op de laptops mogen. Het tweede geldt ook voor wie met een API-key inlogt.

Afdwingen op de laptops met requirements.toml

Het bestand staat op macOS en Linux in /etc/codex/requirements.toml en op Windows in %ProgramData%\OpenAI\Codex\requirements.toml; via de Agent security-instellingen in de cloud of macOS MDM kan het ook. Drie voorbeelden:

features.plugins = false

[marketplaces]
restrict_to_allowed_sources = true

[marketplaces.allowed_sources.openai]
source = "git"
url = "https://github.com/openai/plugins.git"

[mcp_servers.docs]
identity = { url = "https://example.com/mcp" }

De eerste regel zet plugins helemaal uit. De tweede laat alleen goedgekeurde marketplaces toe; wil je de officiële catalogus houden, dan moet die er expliciet in staan. De derde staat alleen MCP-servers toe waarvan naam en identiteit kloppen; een lege mcp_servers-tabel zet alle MCP-servers uit.

Wat die regels niet afdekken

De marketplace-regels gelden voor de ChatGPT- en Codex-desktop-app en de Codex CLI. Ze sturen ChatGPT op het web en mobiel niet; dat regel je in de werkruimte. Meer over beheer, approval-beleid en de Compliance API staat op Codex privacy en beveiliging.

Risico's

Codex plugins en je data: rechten, AVG en wat er blijft hangen

Een plugin werkt met jouw account en dus met jouw rechten. Kan jij in de gedeelde mailbox, dan kan Codex dat via de Outlook-plugin ook. Daar begint elke risicoafweging.

Wie wat ziet

In Codex geldt het sandbox- en goedkeuringsbeleid van de host. De externe dienst houdt zijn eigen inlog en toegangsrechten. Data die via een MCP-server loopt, valt onder de voorwaarden en het privacybeleid van die dienst. Bij Sign in with ChatGPT (beta, onder meer bij Airtable, GitLab, HubSpot, Notion, Supabase en Vercel) deelt OpenAI alleen je naam, e-mailadres en profielfoto met de partner; toegang tot data keur je apart goed.

De AVG-kant voor een Nederlands bedrijf

Haalt Codex klantmails of dossiers op via een plugin, dan verwerkt OpenAI die inhoud. Gebruik daarvoor een zakelijk abonnement: bij Business en Enterprise traint OpenAI standaard niet op je data en kun je een verwerkersovereenkomst sluiten. Neem de koppeling op in je verwerkingsregister en spreek af welke mailboxen en mappen erbij mogen. Dataresidentie in de EER, en de uitzondering voor Codex Web, staan op Codex privacy.

Opdrachten verstopt in data

Een mail, issue of webpagina kan tekst bevatten die zich als instructie voordoet. Leest Codex die via een plugin, dan kan hij erop reageren. Zet koppelingen met schrijfrechten daarom op writes of prompt, zodat elke verzend- of wijzigactie langs jou komt. De achtergrond staat bij prompt-injectie.

Plugins van derden

Een community-marketplace toevoegen is één commando, en daarmee ook één commando van code van een onbekende op je laptop. Kijk eerst naar drie dingen: staat er een .agents/plugins/marketplace.json in, is er een licentie, en wanneer is er voor het laatst aan gewerkt? Hooks in een plugin draaien pas nadat jij ze hebt beoordeeld en vertrouwd; lees ze dan ook echt. Meer criteria staan bij skills van derden.

Valkuil

De grootste valkuil: alles aanzetten en Codex laten schrijven

Het patroon dat we het vaakst zien: iemand installeert in de eerste week vijf of zes plugins, verbindt ze allemaal met schrijfrechten en laat de goedkeuring op auto staan. Dat gaat op drie manieren mis.

Wat je in plaats daarvan doet

Installeer één plugin voor het systeem waar je werk elke dag in zit. Zet MCP-goedkeuring op writes. Schrijf één skill die zegt hoe jullie het doen, bijvoorbeeld: "Lees de mail, vat samen in drie regels, stel een concept op, verstuur nooit zelf." Kijk na een week in /mcp en je gebruik wat Codex aanroept, en voeg pas dan een tweede toe. En vergeet de nieuwe sessie niet na installatie: anders test je zonder de plugin en concludeer je ten onrechte dat hij niet werkt.

Ons oordeel

Ons oordeel over Codex plugins voor een Nederlands mkb-team

Plugins zijn de moeite waard zodra je werk in Microsoft 365, Google Workspace of GitHub zit en je team via een ChatGPT Business-werkruimte inlogt. Dan heb je in een kwartier een werkende koppeling, met beheer erbij. Voor de rest van het Nederlandse mkb-pakket, de boekhouding voorop, zijn ze er nog niet.

Wanneer wel

Kies plugins als je team in de desktop-app of de CLI werkt, met een ChatGPT-login, en de systemen gebruikt die in de catalogus staan. De Outlook-, Teams- en SharePoint-plugins dekken de Microsoft-omgeving die de meeste Nederlandse kantoren hebben. Voeg er eigen skills in het Nederlands aan toe: de plugins zelf bevatten geen werkwijze, en de Engelstalige beschrijvingen zeggen niets over jullie toon of klanten. Een eigen repo-marketplace loont vanaf het moment dat meer dan twee mensen dezelfde skills gebruiken.

Wanneer niet

Niet als je team in de IDE-extensie werkt: daar draaien plugins niet. Niet als je met een API-key inlogt en Outlook of Gmail nodig hebt: die vallen dan af. En niet voor Exact, AFAS, Moneybird, Twinfield of SnelStart: daarvoor bestaat geen officiële plugin. Daar heb je een eigen MCP-server nodig, liefst alleen-lezen. Hoe dat voor Exact werkt, staat in de tutorial Exact Online koppelen; dezelfde MCP-server werkt in Codex. Wil je zo'n koppeling met je team laten bouwen, met afspraken over rechten en tokens, dan is dat precies waar de Agent Sprint voor is.

Een voorbeeld uit het mkb

Neem een installatiebedrijf met een kantoorteam in Microsoft 365 en de administratie in Exact. Een werkbare opzet: de admin zet in de Business-werkruimte de Outlook-email- en SharePoint-plugin op Available voor de kantoorrol. In een kleine repo-marketplace staat één eigen plugin met twee skills: offerte-opvolging en een weekoverzicht van openstaande serviceverzoeken. Exact blijft buiten Codex tot er een alleen-lezen MCP-koppeling is met akkoord van de boekhouder. Resultaat: Codex leest mee in mail en documenten, schrijft concepten in de eigen toon en verstuurt niets zelf.

De fout die we in trainingen het vaakst zien

Te veel tegelijk aanzetten, met te veel rechten. Zie de grootste valkuil. De tweede is de omgekeerde: een team installeert een plugin, test in dezelfde sessie, ziet niets gebeuren en concludeert dat het niet werkt. Een nieuwe sessie lost dat op.