Knowledge · MCP

    OAuth MCP vs API-key MCP

    OAuth MCP connects as a real user with revocable consent. API-key MCP connects as a shared machine credential. The operational and audit differences between them.

    What is the difference between OAuth MCP and API-key MCP?

    OAuth MCP makes the assistant act as a specific signed-in user, with consent recorded and access revocable per client. API-key MCP makes it act as a shared machine credential with no user attribution. OAuth preserves per-user permissions and audit attribution; API keys usually flatten both.

    Key takeaways

    • OAuth binds a connection to a user identity and a named client.
    • API keys are shared secrets with no inherent user attribution.
    • Revoking one OAuth client does not disturb other integrations.
    • A leaked API key is a standing grant until someone notices.
    • Audit quality depends on which of the two you chose.

    What each model actually gives you

    • OAuth: per-user identity, explicit consent, per-client revocation, short-lived tokens.
    • API key: fast setup, no user binding, long-lived, revoked only by rotating the secret.
    • OAuth: role and entitlement checks apply naturally to the acting user.
    • API key: permissions have to be attached to the key itself, which tends to over-grant.

    The audit consequence

    When something is created, changed or sent by an assistant, the record needs to name who authorized it. With OAuth, the acting user is present in the token and can be written into the audit row. With a shared key, the honest entry is 'a machine did this', which is not enough when the question is whether the action was approved by someone allowed to approve it.

    Where API keys still make sense

    Server-to-server jobs with no human in the loop — scheduled syncs, internal batch reads — are a reasonable fit, provided the key is scoped narrowly and its actions are attributed to a system actor rather than a person. What is not reasonable is using a shared key to let an external assistant perform work on behalf of unidentified humans.

    Where URBLD fits

    URBLD's MCP endpoint uses OAuth against the platform's own authorization server. Each connecting client registers and is approved on a consent screen, tokens are short-lived and carry the acting user, and the organization is resolved from that user's membership rather than from anything the client sends.

    FAQ

    Frequently Asked Questions

    Straight answers about how URBLD runs the business end-to-end.

    More in MCP

    The protocol that lets AI do work instead of describing it.

    Browse MCP
    Share this page