Conversation
bolinfest
force-pushed
the
pr9192
branch
2 times, most recently
from
697e3a5 to
80aabc4
Compare
etraut-openai
approved these changes
Jan 14, 2026
Collaborator
etraut-openai
left a comment
etraut-openai
left a comment
There was a problem hiding this comment.
Thanks for doing this. I've seen a lot of requests for this from users.
docs/codex-mcp-server.md
Outdated
| @@ -0,0 +1,67 @@ | |||
| ## Using Codex as an MCP Server | |||
Collaborator
There was a problem hiding this comment.
Please don't add documentation back to the OSS repo. It doesn't work to have it in two places. Update these docs instead. I can take care of it after this PR lands if you'd like.
Collaborator
Author
There was a problem hiding this comment.
Sorry, yes, I know, I just asked Codex to write this up when I had it create the PR in the first place. I put this in my personal ~/Documents for now...
bolinfest
force-pushed
the
pr9192
branch
2 times, most recently
from
0682e78 to
0499d0c
Compare
bolinfest
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This favors
threadIdinstead ofconversationIdso we use the same terms as https://developers.openai.com/codex/sdk/.To test the local build:
I sent:
{ "method": "tools/call", "params": { "name": "codex", "arguments": { "prompt": "favorite ls option?" }, "_meta": { "progressToken": 0 } } }and got:
{ "content": [ { "type": "text", "text": "`ls -lah` (or `ls -alh`) — long listing, includes dotfiles, human-readable sizes." } ], "structuredContent": { "threadId": "019bbb20-bff6-7130-83aa-bf45ab33250e" } }and successfully used the
threadIdin the follow-up with thecodex-replytool call:{ "method": "tools/call", "params": { "name": "codex-reply", "arguments": { "prompt": "what is the long versoin", "threadId": "019bbb20-bff6-7130-83aa-bf45ab33250e" }, "_meta": { "progressToken": 1 } } }whose response also has the
threadId:{ "content": [ { "type": "text", "text": "Long listing is `ls -l` (adds permissions, owner/group, size, timestamp)." } ], "structuredContent": { "threadId": "019bbb20-bff6-7130-83aa-bf45ab33250e" } }Fixes #3712.