Static Credentials Integration Guide

Generate a hosted form URL

Call POST /credentials/static/{providerSlug}/connect from your backend. Two headers are required: your Account API Key (Authorization) and the API Key of the specific server you're connecting this user to (x-mewcp-key). Pass the user's ID and, if you have a frontend, a callback URL. You can also pass optional user metadata, which MewCP stores alongside the credential for display in your dashboard:

Code
POST /credentials/static/gemini/connect
Authorization: Bearer MEWCP_ACCT_API_KEY
x-mewcp-key: MEWCP_API_KEY

{
  "externalUserId": "user_123",
  "frontendCallbackUrl": "https://yourapp.com/credentials/callback",
  "externalUserMeta": {
    "name": "Jane Smith",
    "email": "jane@example.com",
    "username": "janesmith"
  }
}

If x-mewcp-key is missing, invalid, not a business-mode server key, or belongs to a different provider than {providerSlug} in the path, the call fails with 401/400 before any form URL is generated.

You get back:

Code
{
  "hostedFormUrl": "https://gateway.mewcp.com/connect/static?token=...",
  "expiresInMinutes": 5
}

The URL is valid for 5 minutes. Generate it close to when the user will open it.

Send the URL to your user

If you have a frontend (web app):

Redirect the user to the hostedFormUrl, or open it as a new tab:

Code
// Redirect the current page
window.location.href = hostedFormUrl;

// Or open as a new tab
window.open(hostedFormUrl, "_blank");

After the user submits their credentials, MewCP redirects to your frontendCallbackUrl:

Handle the result on your callback page:

Code
// On your frontendCallbackUrl page
const params = new URLSearchParams(window.location.search);
if (params.get("success") === "true") {
  // show success, redirect to dashboard, etc.
}

If you have no frontend (local tools / server-only setups):

Open the hostedFormUrl in a browser, fill in the API key, and submit. MewCP will show a "Connected" confirmation page. The credential is saved, no further action needed.

Other delivery methods:

• Email the link to the user
• Show it as a button in your app's settings page
• Send it via an in-app notification

Just ensure the user opens it within 5 minutes of generation.

Use the connection 🚀

Once connected, route your user's MCP requests through the gateway with their externalUserId in the header:

Code
x-external-user-id: user_123

MewCP resolves the stored credential and injects it into the provider call.