MC-1 DOCS
API ReferenceCookbook
Docs/Architecture guides/OpenAI → MC-1
PublishedGuidanceLAST REVIEWED · 30 AUG 2026

OpenAI → MC-1

Migrate incrementally from openai → mc-1 while preserving working behavior and attribution.

What changes

Keep the existing client behavior stable first. Introduce the MC-1 base URL, logical model, and server-side credential, then add control-plane constraints only after compatibility passes.

Feature mapping

  • Keep the OpenAI SDK; change baseURL to MC1_BASE_URL.
  • Replace a provider model with colomboai/mc-1, or keep an eligible explicit model.
  • Validate Responses, Chat Completions, streaming, tools, and structured output separately.

Migration sequence

  • Inventory endpoints, models, streaming, tools, retries, and error handling.
  • Create a scoped MC-1 project and test key.
  • Run an owned non-production fixture through both paths.
  • Compare outputs, tool continuation, latency, usage, and failures.
  • Canary a reversible workload before broader promotion.

Compatibility example

export MC1_API_KEY="..."
export MC1_BASE_URL="https://api.colomboai.com/v1"
# Keep the client OpenAI-compatible and use model colomboai/mc-1.

Source-specific caveats

  • Provider-specific beta headers and unsupported fields are not translated automatically.
  • Preserve the direct OpenAI path until workload acceptance passes.

Rollback

  • Retain the previous route until acceptance passes.
  • Do not translate unsupported provider-specific features silently.
  • Record the exact client and integration versions used for validation.
End of guide
Was this page helpful?