Appearance

Use Socifyr from Codex ​

Codex can use Socifyr two ways: as a local MCP server started with npx -y @socifyr/mcp, or by running the socifyr CLI in the shell. Both use the same API key. Create one in the dashboard under API Keys and note your workspace ID.

How do I run the Socifyr MCP server for Codex? ​

Codex reads MCP servers from its configuration file. Add a stdio server that runs the package with the two required variables:

toml
[mcp_servers.socifyr]
command = "npx"
args = ["-y", "@socifyr/mcp"]

[mcp_servers.socifyr.env]
SOCIFYR_API_KEY = "sk_..."
SOCIFYR_WORKSPACE_ID = "69fbbf978e770da397a59a5a"

The server prints Socifyr MCP server running on stderr and exits with an error if either variable is missing. For a self-hosted API, also set SOCIFYR_API_URL. Check the Codex documentation for the current config file location and whether it also accepts remote HTTP servers; the Socifyr side is the command and variables above.

How do I use the CLI instead? ​

Install the CLI and let Codex run it. This is the simplest path when your agent can use a shell:

bash
npm install -g @socifyr/cli
socifyr configure --key sk_... --workspace 69fbbf978e770da397a59a5a
socifyr connections
socifyr post "Shipped v2.0" --to x-myhandle,linkedin-myhandle --wait

Add a line to your repository's agent instructions so Codex knows the commands exist. See CLI reference for every flag.

What can I ask Codex? ​

  • "Post the release notes in RELEASE.md to LinkedIn." With the MCP server, Codex calls list_connections and post_text. With the CLI, it runs socifyr post --file RELEASE.md --to linkedin-myhandle.
  • "Schedule the posts in posts.csv." Codex runs socifyr schedule posts.csv, or calls schedule_posts. See Bulk schedule from a CSV.

How do I limit what Codex can do? ​

Use a dedicated key with a daily limit and required approval. See Approvals and guardrails.

FAQ ​

Does the CLI install under the name socifyr? ​

Yes. See CLI installation.

Why not use the hosted MCP URL? ​

You can, if your Codex version supports remote servers with custom headers. Use https://api.socifyr.com/api/mcp with Authorization: Bearer sk_....

Next steps ​