API & Integrations

    MCP security model and role scopes

    MCP tokens inherit the calling member's role, further clamped by an optional role override. Writes require confirm. Admin actions require admin.

    Updated 2026-07-10
    1 min read
    mcp
    security
    rbac

    Quick answer#

    Effective role = min(member role, token role override). Read tools need viewer+, writes need member+ and confirm: true, and add_maintenance_window needs admin.

    Guardrails#

  1. Tokens are org-scoped — never cross-tenant
  2. Every call re-validates the calling member's role
  3. Prompt-injection defense: writes require explicit confirm: true from the model
  4. Full audit trail in api_request_logs
  5. Where to find it in Lemwatch#

    Settings → MCP tokens → Role override when issuing a token.

    How to lock a token down#

  6. Issue a token with role override = viewer.
  7. Give it to your AI client for read-only workflows.
  8. Keep admin-capable tokens for humans only.
  9. Rotate quarterly.
  10. FAQ#

    Can a token escalate its own role?#

    No. Role override can only *reduce* privileges.

    What if a member is removed?#

    All tokens they created continue to work (they're org-scoped), but you should revoke any they no longer need.

  11. Manage MCP tokens
  12. MCP tool catalog
  13. Roles and permissions
  14. Was this article helpful?