Skip to content

Conversation

@threepointone
Copy link
Contributor

Documentation sync for cloudflare/agents#652

This PR documents the MCP storage adapter architecture introduced in the Agents SDK.

Changes:

  • Added advanced-client-api.mdx explaining the MCPStorageAdapter interface and custom storage backends
  • Updated oauth-mcp-client.mdx with security considerations for OAuth callback URL clearing
  • Updated mcp-client-api.mdx to link to the new advanced configuration guide

Key documentation topics:

  • Storage adapter pattern for MCP client manager
  • OAuth security improvements (callback URL clearing)
  • Custom storage backend implementation guide
  • Connection restoration after hibernation

Documents the MCP client manager refactoring that introduces a storage
adapter interface and implements automatic OAuth credential cleanup for
enhanced security.

Changes:
- Add new mcp-storage.mdx explaining storage adapter architecture
- Document automatic OAuth credential cleanup after authentication
- Add security notes about replay attack prevention
- Document automatic connection restoration after hibernation
- Update OAuth guide with security information

Related PR: cloudflare/agents#652

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@github-actions github-actions bot added size/m product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. labels Nov 14, 2025
@github-actions
Copy link
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/agents/ @irvinebroque, @rita3ko, @elithrar, @thomasgauvin, @threepointone, @cloudflare/pcx-technical-writing

- Add new storage-adapter.mdx page documenting the MCPStorageAdapter interface
- Update mcp-client-api.mdx to reference storage adapter pattern
- Document breaking change: MCPClientManager now requires storage option
- Include migration guide for direct MCPClientManager usage
- Document security improvements in OAuth credential handling

Related to cloudflare/agents#652
@github-actions
Copy link
Contributor

CI run failed: build logs

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

Labels

product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants