Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

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

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#13 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
78/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
python
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với tests/integration/run-vs-codex.sh và phần tích hợp trong README để tìm cách thiết lập Codex CLI đã được kiểm thử và vị trí liên kết đến trang mới. Thêm một trang trong docs/ trình bày lệnh codex mcp add, việc xuất token, dọn dẹp máy chủ tạm thời, chế độ sandbox và luồng OPENAPI_SANDBOX_TOKEN. Công việc hoàn tất khi trang được liên kết từ README và bao gồm các bước này.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.
Ngôn ngữ chính
Python
Star
22
Fork
4
Merge trung bình
6 phút
Pull request đã merge (30 ngày)
1

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của openapi/mcp-server

Tất cả issue của openapi/mcp-server

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.