Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Docs: add a first-class Codex CLI setup example using `codex mcp add`

Aperta Adatta ai principianti
#13 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
78/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Tranquilla
Stack tecnologico
python
Ambito
documentation

Direzione di ricerca

Inizia da tests/integration/run-vs-codex.sh e dalla sezione di integrazione del README per trovare la configurazione di Codex CLI testata e dove collegare la nuova pagina. Aggiungi una pagina sotto docs/ che tratti il comando codex mcp add, l’esportazione del token, la pulizia del server temporaneo, la modalità sandbox e il flusso OPENAPI_SANDBOX_TOKEN. Il lavoro è terminato quando la pagina è collegata dal README e include questi passaggi.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Opened by @francescobianco from local draft 03-codex-cli-setup-docs.md.

Summary

This repo already has a Codex integration test, but I could not find a user-facing setup guide for Codex CLI. A small copy-pasteable example would help a lot.

Reproduction

  1. Install @openai/codex.
  2. Start openapi-mcp-sdk server.
  3. Try to connect Codex manually.
  4. Discover that the best example currently lives in tests/integration/run-vs-codex.sh.

Expected

A short doc section showing:

  • codex mcp add <name> --url http://localhost:8080 --bearer-token-env-var OPENAPI_MCP_TOKEN
  • how to export the token
  • how to remove the temporary server

Actual

There is no dedicated Codex setup page in docs/.

Why this is a good first issue

The implementation already exists and is tested. This is mostly extracting a polished example from the integration script.

Suggested acceptance criteria

  • Add a Codex CLI setup page under docs/.
  • Link it from the README integration section.
  • Mention sandbox mode and the OPENAPI_SANDBOX_TOKEN flow.
Lingua principale
Python
Stelle
22
Fork
4
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di openapi/mcp-server

Tutte le issue di openapi/mcp-server

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.