feat(workspace): add MCP servers to workspace configuration

[feloy]

Add McpConfiguration, McpServer, and McpCommand schemas to the workspace-configuration OpenAPI spec, allowing users to configure URL-based and command-based MCP servers in their workspace.

Fixes #32

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 619306f7-4c64-41fc-8f4c-06e380e90dde

📥 Commits

Reviewing files that changed from the base of the PR and between c74cac8 and 4df87d9.

📒 Files selected for processing (1)

• workspace-configuration/openapi.yaml

🚧 Files skipped from review as they are similar to previous changes (1)

• workspace-configuration/openapi.yaml

---

📝 Walkthrough

Walkthrough

Adds an mcp property to the WorkspaceConfiguration OpenAPI schema and introduces three new schemas—McpConfiguration, McpServer, and McpCommand—with examples; each MCP schema level disallows additional properties.

Changes

Cohort / File(s)	Summary
OpenAPI Schema: Workspace configuration workspace-configuration/openapi.yaml	Added WorkspaceConfiguration.mcp and three new schemas: McpConfiguration (servers, commands), McpServer (required name, url, optional headers object), and McpCommand (required name, command, optional args array, env object). Set additionalProperties: false for MCP schemas and updated the 200 response example to include mcp with a sample server and command.

Sequence Diagram(s)

(omitted — changes are schema additions without multi-component runtime control flow)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• feat(workspace): add skills field to WorkspaceConfiguration schema #31 — Also modifies WorkspaceConfiguration in workspace-configuration/openapi.yaml by adding a top-level property (skills), touching the same schema file and potentially overlapping schema concerns.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main change: adding MCP servers to workspace configuration, which is the primary focus of the changeset.
Description check	✅ Passed	The description is clearly related to the changeset, explaining the new schemas added and their purpose for configuring MCP servers in workspaces.
Linked Issues check	✅ Passed	The PR implementation fully addresses issue #32 requirements: McpConfiguration with servers and commands arrays, McpServer with name/url/headers, and McpCommand with name/command/args/env properties.
Out of Scope Changes check	✅ Passed	All changes in workspace-configuration/openapi.yaml are directly related to implementing the MCP server configuration feature requested in issue #32, with no extraneous modifications.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@workspace-configuration/openapi.yaml`:
- Around line 100-114: The McpCommand schema currently lists required: name,
command but leaves args optional; update the OpenAPI schema for McpCommand by
adding "args" to the required array so that the properties block (name, command,
args) enforces presence of args; ensure the existing args property definition
(type: array, items: string) remains unchanged and keep optional env as-is if
present elsewhere.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 16420f9e-6850-4da2-8368-c5d681c13be5

📥 Commits

Reviewing files that changed from the base of the PR and between 5d1cecc and c74cac8.

📒 Files selected for processing (1)

• workspace-configuration/openapi.yaml