HOLD FOR LAUNCH private bridge MCP server setup guide by mindymo · Pull Request #365 · ConductorOne/docs · GitHub
Skip to content

HOLD FOR LAUNCH private bridge MCP server setup guide#365

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

HOLD FOR LAUNCH private bridge MCP server setup guide#365
mindymo wants to merge 8 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

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

- 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>
jugonzalez12 and others added 2 commits June 26, 2026 12:01
- Correct the credential button label (Create vs Rotate credential)
- Add environment-variable and Vault configuration modes; link the bridge setup guide
- Remove the config-check validation step
- Document the registration authentication step and the app-user requirement for tool calls
- Explain code-mode discovery and invocation for capable clients
- Note that discovery uses the tool descriptions and schemas the server advertises
- Fix the verify-connection steps (Test credentials reports the discovered tool count)
- Add the http transport type and use "C1 Bridge"

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
That a robot thought was awkward.
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.

2 participants