update codex mcp config (#8)

Author: ianjkaplan

GETTING_STARTED.md

@@ -69,6 +69,24 @@ script runs `codex mcp login unify` only when one is present. Without a TTY it
 skips sign-in and tells the user to restart Codex and run the login command
 themselves.
 
+Codex uses a global OAuth callback port rather than the callback port declared
+by an individual plugin. Before signing in, add this top-level setting to
+`~/.codex/config.toml` (outside any `[table]` section):
+
+```toml
+mcp_oauth_callback_port = 1455
+```
+
+Alternatively, set the port for only the Unify login command:
+
+```bash
+codex -c mcp_oauth_callback_port=1455 mcp login unify
+```
+
+The fixed port must match the callback URL registered for the Codex OAuth
+client. Without this setting, Codex selects a random port and Auth0 rejects the
+request with a callback URL mismatch.
+
 ## Finish and verify
 
 Fully restart each agent after the script completes. A new chat in an existing
@@ -140,6 +158,7 @@ then `/reload-plugins` (or fully restart the agent) to load the new code.
 | Tools are missing after setup                    | Fully quit and restart the agent.                                                                     |
 | Cursor does not show the plugin                  | Confirm the organization allows user-local plugin imports.                                            |
 | Authentication was skipped or failed             | Re-run the same setup command, or omit `--no-auth`. The install steps are idempotent.                 |
+| Codex reports an OAuth callback URL mismatch      | Set top-level `mcp_oauth_callback_port = 1455` in `~/.codex/config.toml`, restart Codex, and retry.    |
 | Sign-in was skipped (no interactive terminal)    | Fully restart the agent, then complete the login flow inside it — in Claude Code, the `/mcp` command. |
 | Signed in, but tools still fail                  | Restart the agent so its MCP process reloads the stored session.                                      |
 | "workspace does not have chat funding available" | Ask a Unify workspace admin to check the workspace plan or credits.                                   |

scripts/setup.sh

@@ -189,7 +189,7 @@ authenticate_cursor() {
   ensure_temp_dir
   auth_dir="$TEMP_DIR/cursor-auth"
   mkdir -p "$auth_dir/.cursor"
-  cp "$HOME/.cursor/plugins/local/$PLUGIN/mcp.json" "$auth_dir/.cursor/mcp.json"
+  cp "$HOME/.cursor/plugins/local/$PLUGIN/mcp.cursor.json" "$auth_dir/.cursor/mcp.json"
 
   log "Signing in to Unify for Cursor"
   (

unify/.app.json

@@ -0,0 +1,7 @@
+{
+  "apps": {
+    "unify": {
+      "id": "asdk_app_6a74c969e59081918d748ff307e7d97a"
+    }
+  }
+}

unify/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "unify",
   "displayName": "Unify",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Run Unify's GTM agent from Claude Code — build company and people lists, enrich emails and phone numbers, and launch sequences and tasks.",
   "author": { "name": "Unify", "url": "https://www.unifygtm.com" },
   "homepage": "https://www.unifygtm.com",

unify/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "unify",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Run Unify's GTM agent from Codex — build company and people lists, enrich emails and phone numbers, and launch sequences and tasks.",
   "author": { "name": "Unify", "url": "https://www.unifygtm.com" },
   "homepage": "https://www.unifygtm.com",
@@ -9,6 +9,7 @@
   "keywords": ["unify", "gtm", "sales", "prospecting", "enrichment", "outbound", "crm"],
   "skills": "./skills/",
   "mcpServers": "./mcp.codex.json",
+  "apps": "./.app.json",
   "interface": {
     "displayName": "Unify",
     "shortDescription": "GTM workflows with Unify agents",

unify/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "unify",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Run Unify's GTM agent from Cursor — build company and people lists, enrich emails and phone numbers, and launch sequences and tasks.",
   "author": { "name": "Unify" },
   "homepage": "https://www.unifygtm.com",

unify/mcp.codex.json

@@ -3,9 +3,8 @@
     "unify": {
       "type": "http",
       "url": "https://mcp.unifygtm.com/mcp",
-      "oauth_resource": "https://mcp.unifygtm.com/mcp",
       "oauth": {
-        "client_id": "VU9S5uuNCXgLASZNmFoCJAYWFZGp19VS"
+        "client_id": "noOdn0wOIcxxTQUbQ3HEggImQAxkIjDf"
       }
     }
   }

unify/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "unify",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Run Unify's GTM agent to build company and people lists, enrich contact data, and launch sequences and tasks.",
   "author": {
     "name": "Unify",

unify/skills/crm/SKILL.md

@@ -13,9 +13,9 @@ and HubSpot and also keeps its own canonical company/person records and Lists.
 > public API exposes direct tools: `list_objects` / `get_object` and their
 > attributes, `get_object_record` / `create_object_record` / `update_object_record`
 > / `upsert_object_record` / `find_unique_object_record` / `delete_object_record`,
-> and the async **Bulk API** for exporting or syncing many records at once (see
-> `bulk-apis`). The agent briefs below remain the path for
-> complex workflows and anything needing reasoning.
+> and the async **Bulk API** tools for exporting or syncing many records at once.
+> The agent briefs below remain the path for complex workflows and anything
+> needing reasoning.
 
 ## Reads (free, live)
 

unify/skills/data-tables/SKILL.md

@@ -12,8 +12,8 @@ run just to see rows you already have.
 > **Not the same as Bulk API results.** A DataTable is an **agent run** artifact,
 > paged here with `load_datatable` (cursor-based, pinned to a `versionId`). The
 > public **Bulk API** returns query-job results paged by `get_<resource>_query_job_results`
-> (`page` / `page_size`, see `bulk-apis`). If you have a `job_id` rather than a
-> `tableId` + `versionId`, use `bulk-apis`, not this skill.
+> (`page` / `page_size`). If you have a `job_id` rather than a `tableId` +
+> `versionId`, use the public Bulk API tools, not this skill.
 
 ## `load_datatable({ tableId, versionId, limit?, cursor? })`