Skip to content

HOLD FOR LAUNCH private bridge MCP server setup guide#365

Open
mindymo wants to merge 6 commits into
mainfrom
docs/mcp-bridge-private-server
Open

HOLD FOR LAUNCH private bridge MCP server setup guide#365
mindymo wants to merge 6 commits into
mainfrom
docs/mcp-bridge-private-server

Conversation

@mindymo

@mindymo mindymo commented Jun 25, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Adds product/admin/mcp-bridge.mdx — a new setup guide for connecting a private/local MCP server to C1 using the bridge agent (bridge-client), with no inbound firewall rules required
  • Registers the page in docs.json under the existing "MCP server setup guides" nav group alongside Datadog
  • Covers: creating a bridge in C1, writing bridge.yaml, validating and running the agent, registering the server in C1, reviewing discovered tools, verifying, troubleshooting, and rotating credentials

Notes for reviewers

This is a first draft from internal developer docs. The design team flagged that the source doc had accuracy issues, so several things still need verification against the actual product UI:

  • Exact wizard step names and labels (Choose a server → Connectivity → Configure)
  • Exact wording of the Private bridge and External MCP server option descriptions
  • Whether bridge-config-check is the correct binary name
  • The Docker/Kubernetes link ("Bridge connector setup guide") — needs a real link once that page exists

Test plan

  • Mintlify preview renders without errors
  • Nav entry appears correctly under "MCP server setup guides"
  • All internal links resolve (tools-and-toolsets, connect-mcp-client, support@c1.ai)
  • UI label review once the feature is accessible

🤖 Generated with Claude Code

New page covering how to connect a private/network-local MCP server to C1
through the bridge agent, with no inbound firewall rules required.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jun 25, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
conductorone 🟢 Ready View Preview Jun 25, 2026, 9:13 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- "ConductorOne download center" → "C1 download center" (prose rule)
- Add outcome sentence after Step 1 <Steps> block
- Add intro sentence before Step 4 <Steps> block (was directly after heading)
- Add outcome sentence after Step 4 <Steps> block
- "Step 6 — Verify" → "Step 6 — Verify the connection" (heading must be descriptive out of context)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Fix button name: "Create credential" → "Rotate credential"
- Fix step order: enter display name before clicking Create bridge
- Update download link to dist.conductorone.com/ConductorOne/bridge-client
- Replace placeholder Kubernetes/Docker note with real deployment tabs,
  including actual ECR image path and manifests
- Fix credential rotation section button names (Rotate/Revoke → Rotate credential/Revoke credential)
- Simplify Step 6 log-tailing prose

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Lead with the barrier (private network, no inbound firewall changes) rather
than the mechanism. Trim from four sentences to two.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@mindymo mindymo changed the title docs: add private bridge MCP server setup guide HOLD FOR LAUNCH private bridge MCP server setup guide Jun 25, 2026
@mindymo

mindymo commented Jun 25, 2026

Copy link
Copy Markdown
Collaborator Author

@jessstarr-hub @jugonzalez12 Hiya! I'm on vacation next week, so here's a draft PR for the bridge docs based on what's in Julián's Notion doc and the registry docs. Please review this and make any adjustments (you can point an agent at the PR and tell it what to do), then approve/merge it when ready. I'm around all day tomorrow if you have questions about any of this. Thanks!

- Replace feature-gate note with "Activation required" pattern (AIAM must be
  enabled; contact support to get bridge connectivity turned on)
- Remove placeholder from release note; add contact CTA and AIAM prerequisite

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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