SAService ArchitectDocumentation

/

DocumentationCodex & MCP

Reference

Codex & MCP

Use Codex and MCP for AI-assisted service design through a typed, validated architecture API instead of editing topology YAML by guesswork.

Getting Started

AI service design with Codex and MCPThe Service Architect plugin lets Codex inspect, author, validate, export, and generate projects through a graph-aware interface.Install the Codex pluginInstall Service Architect from its public repository marketplace and open a new Codex task so the MCP server and skills are discovered.

Agent Workflow

Work with a topology in CodexGive Codex intent and constraints; let it inspect the manifest, change typed declarations, validate, and show the resulting architectural diff.

Semantic Authoring

Service and connector boundariesKeep stream edges inside a service and represent every cross-service flow through a connector endpoint.Call semantics, pools, and failuresChoose links from execution intent and model failure flow explicitly.

Tools and Resources

MCP tools and resourcesTools perform explicit operations; resources provide passive context that Codex can inspect before choosing an operation.

Validation and Security

Versioned validation contractServiceGen publishes deterministic metadata for every public SG_* diagnostic while retaining one authoritative validator implementation.Credentials and trust boundariesMost MCP operations are local; only generated code requests require a Service Architect API credential.