root 74873d831e Harden fallback in SKILL.md stub to fail fast on MCP auth failures
Previous fallback was too soft: "discover intent, pick the best tool,
confirm assumptions" was interpreted by Codex as "search the local
workspace for kb:// material" — which never exists locally and burns
context on fruitless exploration.

New fallback makes the recovery path explicit:
- STOP on Auth required / server unreachable
- surface the exact fix command (`codex mcp login oci-deal-accelerator`)
  to the user
- never reconstruct the KB from local files (server-side only)
- never invent SKUs, pricing, or service quantities
- never generate partial artifacts with inferred data

Scoped: applies only when the entire MCP session is unreachable.
Per-tool failures still follow the methodology's guidance.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-20 14:02:02 -03:00

OCI Deal Accelerator — Codex Plugin

Codex plugin that connects to the OCI Deal Accelerator MCP server and bundles a companion skill. Distributed internally via ai-lad.com.

What you get

14 tools surfaced through a remote MCP server (streamable HTTP, OAuth 2.1):

  • generate_full_proposal, generate_bom, generate_bom_appca, generate_cost_estimate
  • generate_deck, generate_diagram, generate_business_case
  • run_wa_review, check_feature_compatibility, compare_competitive
  • search_reference_architectures, search_field_findings, report_field_finding
  • score_ecal_readiness

Plus a skill (skills/oci-deal-accelerator/SKILL.md) that guides Codex on when and how to invoke each tool.

Install

Once the plugin is registered in ai-lad.com you will get an <ID>. Replace it below.

Windows (PowerShell)

iwr -UseBasicParsing 'https://ai-lad.com/api/skills/<ID>/install-script?os=windows' | iex

macOS / Linux

curl -fsSL 'https://ai-lad.com/api/skills/<ID>/install-script?os=unix' | bash

The installer downloads the plugin ZIP, extracts it to ~/plugins/oci-deal-accelerator/, merges the ai-factory marketplace entry in ~/.agents/plugins/marketplace.json, and restarts Codex. Policy: installation: "AVAILABLE", authentication: "ON_INSTALL".

First-run authentication

On first install Codex kicks off the OAuth 2.1 + PKCE flow against the MCP server (AS proxy → OCI Identity Domain). A browser window opens; sign in with your Oracle SSO.

The MCP server implements Dynamic Client Registration (RFC 7591), so Codex's ephemeral http://localhost:<port> callback registers itself on the fly — no manual whitelisting in the AS required. Restricted to @oracle.com identities.

Re-authentication

If a tool call fails with Auth required, the OAuth access token has expired and Codex did not refresh it automatically. Re-authenticate without uninstalling:

codex mcp login oci-deal-accelerator

Opens the browser, re-authenticates with Oracle SSO, tools are available again. If that fails, force a clean slate first:

codex mcp logout oci-deal-accelerator
codex mcp login oci-deal-accelerator

As a last resort, uninstall the plugin from /plugins and reinstall — the authentication: "ON_INSTALL" policy triggers a fresh OAuth flow on install.

Repo layout

oci-deal-accelerator-codex/
├── .codex-plugin/
│   └── plugin.json          # Codex plugin manifest
├── .mcp.json                # Remote MCP server config
├── skills/
│   └── oci-deal-accelerator/
│       └── SKILL.md         # Tool-usage guidance
├── assets/                  # logo.png, icon.png, screenshot-1.png
├── README.md
└── .gitignore

References

Description
Codex plugin for the OCI Deal Accelerator — skill + remote MCP server for OCI BOM, cost estimation, architecture diagrams, and competitive analysis.
Readme 133 KiB
Languages
Markdown 100%