Skip to content

docs(ai-gateway): certificates and ca_certificates on MCP Servers and Agents (AI-223) - #7494

Draft
gperanich wants to merge 1 commit into
mainfrom
feature/ai-223-mcp-agent-certs-docs
Draft

gperanich wants to merge 1 commit into
mainfrom
feature/ai-223-mcp-agent-certs-docs

Conversation

@gperanich

@gperanich gperanich commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Documents the new config.certificates and config.ca_certificates fields on AI MCP Servers and AI Agents (Aha! AI-223, 2.3 GA). Platform API change: Kong/platform-api#3670 (fields gated to minimum runtime version 2.3).

  • app/_ai_gateway_entities/ai-mcp-server.md: new ## Upstream TLS section with {% new_in 2.3 %} — field table, by-name semantics, maxItems: 1 and private-key requirement on certificates, default trust store behavior for ca_certificates, YAML example, cross-links to the AI Certificate / AI CA Certificate entities, and a new FAQ. Notes the fields apply to every mode that proxies to an upstream (conversion-only, conversion-listener, passthrough-listener, upstream-server) and not to listener mode, which has no upstream of its own.
  • app/_ai_gateway_entities/ai-agent.md: same treatment for agent upstreams (a2a and http types).
  • app/_ai_gateway_entities/ai-certificate.md / ai-ca-certificate.md: related_resources and FAQ cross-references noting consumption by MCP Servers and Agents for upstream TLS.

Note: the {% entity_schema %} tables render the new fields automatically once the updated Konnect AI Gateway OAS syncs into api-specs/ from platform-api; no spec edits in this PR.

Validation

  • Frontmatter validation clean (make validate-frontmatters).
  • vale: 0 errors, 0 warnings on the four touched files.

Drafted via the AI-223 roadmap pipeline.

@netlify

netlify Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit efb29b2
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/6ac6f70ffa3e960009ba806d
😎 Deploy Preview https://deploy-preview-7494--kongdeveloper.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant