Skip to content

Clarify remote MCP provider transport support#1058

Draft
mimeding wants to merge 1 commit into
osaurus-ai:mainfrom
mimeding:codex/issue-416-mcp-stdio-docs-draft
Draft

Clarify remote MCP provider transport support#1058
mimeding wants to merge 1 commit into
osaurus-ai:mainfrom
mimeding:codex/issue-416-mcp-stdio-docs-draft

Conversation

@mimeding
Copy link
Copy Markdown
Contributor

Business reason

Users were led to believe command-based stdio MCP providers could be added through the remote-provider UI, which creates failed setup paths and unnecessary support churn. This draft makes the supported transport explicit before users save or test a provider.

Coding rationale

The remote-provider path currently uses HTTP/SSE transport only. This change centralizes endpoint validation, rejects non-HTTP endpoints with a specific error, updates the Settings UI copy/validation, and pins the behavior with focused tests.

Draft status

This is intentionally draft because PR #1048 is the green local-CI parent and has not merged yet. The clean diff is based on current origin/main; focused validation already passed on the stacked #1048 base.

Readiness Block

Local CI parity: GAP+blocked by #1048 baseline (commit: 7d1f3c1)
GitHub CI status: PENDING (headRefOid: pending push)
Merge state: PENDING
Known gaps: current origin/main still needs #1048's build/lint stabilization before this can be marked ready

Reviewer Summary

What this PR adds: Clear HTTP/SSE-only remote MCP provider validation and docs.
What it depends on: #1048 landing first so the local gate baseline is green.
What depends on it: Issue #416 closure evidence.
New public API surface: MCPProviderManager.validatedHTTPSEndpoint(from:).
New tests: 4 focused Swift Testing cases in MCPProviderEndpointValidationTests.
Test corpus: none.
Local gate: GAP on main; PASS when stacked on #1048.
Risk: Low, scoped docs/UI validation and transport guard.
Out of scope: Implementing command-based stdio provider support.

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