The trust architecture behind Yodu: one Docker container per workspace, command-queue-only access, keys you can rotate but never read, and an approval gate on every irreversible action.
Yodu team
Yodu team
Updated · 5 min read

A healthy MCP server is not automatically a safe MCP server.
Health proves that the endpoint can be reached and speaks the expected protocol. Safety depends on authorization, tool design, data scope, employee switches, and review.
Secure an MCP server by exposing the smallest useful tool surface, enforcing authorization at the server, using HTTPS and short-lived scoped credentials, validating every request, granting one employee first, and requiring human approval for consequential actions. A successful health check proves reachability, not least privilege or safe behavior.
First identify the direction of the connection. Platform MCP lets an external client operate one Yodu workspace; employee MCP usage lets a Yodu employee call an external server; a custom MCP entry stores that external server's workspace configuration. Apply separate keys, scopes, and reviews to each boundary. See Yodu scopes and security for the Platform MCP side.

Write the exact job the server enables.
Good:
Let the support lead retrieve the last 30 days of product usage for one customer while investigating a ticket.
Weak:
Give the AI access to our backend.
If the need cannot be described narrowly, the tool surface is probably too broad.
Prefer one business action per tool:
get_customer_usagesearch_contractslist_open_invoicesdraft_crm_noteAvoid:
run_sqlexecute_codeadmin_actiondo_everythingNarrow names are not enough. Validate inputs, enforce authorization on the server, and limit the data returned.
The official MCP authorization specification uses OAuth 2.1, protected-resource metadata, authorization-server discovery, resource indicators, and S256 PKCE for remote protected servers.
Prefer:
Yodu supports workspace-shared OAuth and static request headers. OAuth tokens refresh behind Yodu's central gateway and neither credential type is written to employee runtime files. If a provider requires a pre-registered application, a workspace manager can supply its client ID, optional secret, scopes, and token authentication method in advanced settings. Enter credentials only in that settings flow—never in chat, memory, files, or task descriptions.
The endpoint should be remotely reachable over HTTPS. Keep production MCP tools on a dedicated, monitored route rather than exposing a general internal admin API.
Add the server under Tool access → Custom MCP and wait for the health state. Use re-test after changing the URL or credential.
Health confirms basic connectivity. Continue with a tool-level test.
Choose a tool that reads a known record. Assign the test to one employee with a known input and expected output.
Verify:
Do not make the capability broadly available because the server is healthy. A custom MCP server follows the same rule as a catalog app: one switch per employee, on means the employee sees the tools, off hides them entirely. Leave it on for the role that needs the job and switch it off for everyone else. Consequential actions still pause at the approval gate.
Require human approval when an MCP tool can:
OWASP's Top 10 for Agentic Applications identifies excessive agency as a central risk. The per-employee switch, the approval gate, and the MCP server's own authorization should reinforce each other.
Include:
The server must reject invalid or unauthorized requests even if the model asks confidently.
Know how to:
In Yodu, removing a custom MCP server immediately removes its local gateway credential for the entire workspace and attempts provider-side token revocation. Dependent runtime entries are also queued for cleanup.
| Metric | Why it matters | | ------------------------- | ----------------------------------- | | Health-check success | Basic availability | | Authorized tool success | Whether scoped calls work | | Denied-request rate | Whether policy is being exercised | | Wrong-scope tests blocked | Authorization quality | | Approval rejection rate | Whether write requests are sensible | | Credential age | Rotation hygiene | | Unused tools exposed | Excess attack surface |
Connect the smallest useful surface. Expand from evidence, not from the convenience of having one powerful endpoint.
Follow the custom MCP server guide, review MCP servers and AI tool integrations, then confirm how Yodu separates workspace connections from employee switches.
Practical guides related to this workflow.
The trust architecture behind Yodu: one Docker container per workspace, command-queue-only access, keys you can rotate but never read, and an approval gate on every irreversible action.
Yodu team
A launch note on deleting draft-only, approval-required, autonomous, and revoked: three of the four tiers gated nothing, so tool access became one honest switch.
Yodu team
Connect Claude Code to Yodu's Platform MCP, verify the workspace boundary, and use 53 curated tools without exposing stored secret values.
Yodu team