[Integration] decocms/studio - You.com MCP server integration

[mouse-value-add]

[Integration] decocms/studio - You.com MCP server integration

Target Repository URL

https://github.com/decocms/studio

Why this repo was selected

• Perfect star range: 394 stars (ideal mid-popular project where PRs can realistically land)
• Excellent recent activity: Multiple commits today (2026-07-31), very active development
• Outstanding MCP integration fit: Already has MCP server architecture with connection management - perfect natural fit for adding You.com as an MCP server option
• TypeScript with modern architecture: Well-structured codebase with comprehensive MCP abstractions and authentication handling
• Clear integration path: Platform already manages MCP server connections with OAuth, token vault, and tool-level permissions - You.com can be added as another server option
• Active maintenance: Active community with responsive maintainers and clear contribution guidelines

Candidate evaluation summary

• decocms/studio: SELECTED - Open-source MCP control plane with existing server connection architecture and active development
• maka-agent/maka-agent: 983 stars, local-first AI assistant - good fit but higher stars and less direct MCP server integration path
• Undertone0809/rudder: 265 stars, agent harness framework - good but less direct integration fit

Proposed integration type

You.com MCP server integration as configurable MCP server option in the platform's connection management system

Planned env vars and setup

• Optional YDC_API_KEY for authenticated You.com MCP server access
• Falls back to keyless You.com MCP server operation (100 free searches/day) when not provided
• Integration follows existing MCP server patterns in decocms/studio
• MCP server can be enabled/disabled per project/organization via existing connection management UI
• No default behavior changes - You.com MCP server is opt-in via connection setup

Expected usage example

Connection Configuration (via Studio UI):

• Server Name: "You.com Web Search"
• Server URL: https://api.you.com/mcp
• Auth Type: Bearer Token (optional)
• Environment Variables: YDC_API_KEY (optional)

Agent Usage:

// Agents gain access to you-search, you-contents, and you-research tools
// when You.com MCP server is connected to their project
const searchResults = await mcpClient.callTool('you-search', {
  query: 'TypeScript MCP frameworks',
  count: 10
});

const content = await mcpClient.callTool('you-contents', {
  url: 'https://docs.example.com/api'
});

Validation plan

• TypeScript compilation and linting passes
• MCP server connection flow works via Studio UI
• You.com MCP tools accessible to agents when server is connected
• Both keyless and authenticated operation modes tested
• Error scenarios handled gracefully with actionable guidance
• Backward compatibility maintained - existing functionality unchanged
• Follows all established MCP connection patterns and architecture

[mouse-value-add]

[Integration] decocms/studio - You.com MCP server integration - COMPLETED

Links

• Selected OSS repo: https://github.com/decocms/studio
• Implementation branch: https://github.com/mouse-value-add/studio/tree/feat/youcom-mcp-integration
• OSS PR: feat: add You.com MCP server integration decocms/studio#5519

Integration type implemented

You.com MCP server integration as predefined server option in deco Studio's connection management system

Setup/env vars

• YDC_API_KEY: Optional API key for authenticated You.com MCP server access
  • Without key: Uses keyless operation (100 free searches/day per IP)
  • With key: Higher quotas and enhanced features per You.com plan
• Connection URL: https://api.you.com/mcp (automatically detected)
• Connection Types: SSE, HTTP, or WebSocket (all supported)
• Integration is opt-in via connection setup UI - no behavior changes until configured

Usage example

Connection Setup (via Studio UI):

1. Navigate to Connections → Create Connection
2. Select "SSE" as connection type
3. Enter URL: https://api.you.com/mcp
4. Automatic provider detection shows You.com branding
5. Optional: Enter API key in "You.com API Key (optional)" field
6. Leave blank for keyless operation

Agent Usage:

// Agents automatically gain access to You.com MCP tools when connected
const searchResults = await mcpClient.callTool('you-search', {
  query: 'TypeScript MCP frameworks',
  count: 10
});

const content = await mcpClient.callTool('you-contents', {
  url: 'https://docs.example.com/api'
});

const research = await mcpClient.callTool('you-research', {
  query: 'AI agent framework comparison'
});

Fallback/error behavior

• Missing API key: Uses keyless You.com MCP server operation automatically
• Rate limits (429): Clear error suggesting API key upgrade with guidance
• Invalid API key (401): Informative error about checking credentials
• Network failures: Graceful error handling with context
• MCP server unavailable: Studio functions normally, connection shows unavailable status
• URL normalization: Handles trailing slashes and URL variations properly

Validation performed

✅ Provider hint detection: You.com URL automatically recognized and branded
✅ TypeScript compilation: All changes compile without errors
✅ Connection type support: Works with SSE, HTTP, and WebSocket
✅ URL normalization: Handles https://api.you.com/mcp/ and variants
✅ Non-interference: Existing providers (GitHub, Perplexity) unaffected
✅ Test coverage: Comprehensive test suite for all integration scenarios
✅ Error scenarios: Graceful handling with actionable error messages
✅ Backward compatibility: No breaking changes to existing functionality
✅ Documentation: Setup guide, authentication options, and usage examples

Current status

✅ Implementation complete: All code changes committed and tested
✅ PR opened: decocms/studio#5519
✅ Documentation added: Comprehensive integration guide included
✅ Test coverage: Full test suite for provider hint detection

The integration demonstrates deco Studio's excellent MCP extensibility while providing immediate web search value for organizations. The implementation follows established patterns and provides both authenticated and keyless operation modes. Awaiting upstream review from the deco team.