Skip to content

Add AI agent tooling: skills, MCP servers, and docs#1015

Merged
mosch merged 1 commit into
mainfrom
claude/add-build-ai-docs-Rbe6f
May 20, 2026
Merged

Add AI agent tooling: skills, MCP servers, and docs#1015
mosch merged 1 commit into
mainfrom
claude/add-build-ai-docs-Rbe6f

Conversation

@mosch
Copy link
Copy Markdown
Contributor

@mosch mosch commented May 13, 2026

Introduces comprehensive AI agent support for Zuplo by adding documentation, guides, and infrastructure for AI coding agents to build, configure, and manage API gateways.

Summary

This change establishes Zuplo's AI agent ecosystem by documenting three complementary tools: Agent Skills (task-specific playbooks), the Docs MCP Server (real-time documentation search), and the Developer API MCP Server (programmatic account management). It reorganizes the documentation structure to create a dedicated "Build with AI" section and updates the AI Coding Agents guide to reference the new resources.

Key changes

  • New "Build with AI" section in documentation with four pages:

    • overview.mdx — introduction to all AI agent tools and how they work together
    • skills.mdx — guide to installing and using official Zuplo and Zudoku agent skills from zuplo/tools
    • docs-mcp-server.mdx — setup and usage of the public Docs MCP server at https://dev.zuplo.com/mcp/docs
    • developer-api-mcp-server.mdx — setup, authentication, and security best practices for the authenticated Developer API MCP server at https://dev.zuplo.com/mcp
  • Reorganized AI Coding Agents guide (articles/ai-agents.mdx):

    • Shortened title and refocused on bundled docs setup
    • Removed duplicated skill installation instructions (now in dedicated skills page)
    • Removed duplicated MCP server setup (now in dedicated MCP pages)
    • Added cross-references to the new "Build with AI" resources
    • Restructured "Going further" section to guide users through the full tooling stack
  • Updated sidebar navigation (sidebar.ts):

    • Moved ai-agents from "Development" section to new "Build with AI" category
    • Added new category with icon "sparkles" containing all AI-related documentation
  • CLI reference updates (sidebar.cli.json):

    • Added missing CLI commands: bucket-list, ca-certificate-* (create, delete, describe, list, update), and logout
  • Added policy icons (SVG assets):

    • akamai-firewall-for-ai-inbound.svg
    • akamai-firewall-for-ai-outbound.svg

Implementation details

  • All new documentation follows the repository's style guidelines (American English, present tense, Microsoft Writing Style Guide)
  • MCP server setup instructions are tailored per client (Claude Code, Cursor, VS Code/GitHub Copilot, generic HTTP)
  • Security best practices are emphasized for the authenticated Developer API MCP server
  • Cross-references use relative paths with .md/.mdx extensions as per conventions
  • Portal shortcut links use the /+/ format for account and project-level navigation

https://claude.ai/code/session_01C7ezNV44g8k15ELTCZcpLS

@vercel
Copy link
Copy Markdown

vercel Bot commented May 13, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 20, 2026 6:54am

Request Review

@mosch mosch force-pushed the claude/add-build-ai-docs-Rbe6f branch from 22ce84c to c750e8c Compare May 15, 2026 12:21
@mosch mosch force-pushed the claude/add-build-ai-docs-Rbe6f branch from c750e8c to 415235a Compare May 15, 2026 12:25
@mosch mosch force-pushed the claude/add-build-ai-docs-Rbe6f branch from 415235a to 5438489 Compare May 15, 2026 13:27
@mosch mosch requested a review from ntotten May 15, 2026 13:35
@mosch mosch force-pushed the claude/add-build-ai-docs-Rbe6f branch 2 times, most recently from 91eec55 to 75567cb Compare May 20, 2026 06:05
@mosch mosch force-pushed the claude/add-build-ai-docs-Rbe6f branch from 75567cb to 4d53c2c Compare May 20, 2026 06:15
Introduce a new top-level "Build with AI" section that documents Zuplo's
agent tooling in one place:

- Overview of agent tooling and how the pieces fit together
- Agent skills from zuplo/tools with install instructions for each client
- Docs MCP server (https://dev.zuplo.com/mcp/docs) for docs search and Q&A
- New Developer API MCP server (https://dev.zuplo.com/mcp) for managing
  accounts, deployments, API keys, custom domains, tunnels, and more

The existing AI Coding Agents article (AGENTS.md / bundled docs) moves
under this section and links out to the dedicated skills and MCP pages
to avoid duplication.
@mosch mosch force-pushed the claude/add-build-ai-docs-Rbe6f branch from 4d53c2c to a5e1a27 Compare May 20, 2026 06:18
@mosch mosch merged commit 8fa1d6b into main May 20, 2026
15 checks passed
@mosch mosch deleted the claude/add-build-ai-docs-Rbe6f branch May 20, 2026 07:09
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.

2 participants