Function addUserMcpServerAction

notfair-cmo/src/server/actions/mcp.ts:262–332

(input: {
  display_name: string;
  description?: string;
  resource_url: string;
  /** Optional canonical key override (used by Browse connectors). */
  key?: string;
})

 * `notfair-google-ads`). When omitted, the display name is slugified.
 */
export async function addUserMcpServerAction(input: {
  display_name: string;
  description?: string;
  resource_url: string;
  /** Optional canonical key override (used by Browse connectors). */
  key?: string;
}): Promise<AddUserMcpServerResult> {
  const project = await getActiveProject();
  if (!project) {
    return {
      ok: false,
      kind: "no_project",
      error: "No active project. Pick one before adding an MCP server.",
    };
  }

  let key: string;
  if (input.key && KEY_PATTERN.test(input.key)) {
    key = input.key;
  } else {
    const slug = slugify(input.display_name);
    if (!slug.ok) {
      return {
        ok: false,
        kind: "name_unusable",
        error: `Can't derive a key from this name: ${slug.reason}.`,
      };
    }
    key = slug.slug;
  }

  // Preset re-add: just un-hide. No row to write, no discovery probe.
  if (isPresetKey(key)) {
    const { removeHiddenMcpPresetKey } = await import("@/server/db/projects");
    removeHiddenMcpPresetKey(project.slug, key);
    revalidatePath("/", "layout");
    return { ok: true, key };
  }

  // User row already exists for this key — Browse "click again" path.
  if (findUserMcpServer(project.slug, key)) {
    return { ok: true, key };
  }

  // Same MCP server (same URL) is already in this project under a
  // different key — e.g. NotFair Meta Ads was added pre-canonical-id and
  // saved as `notfair-meta-ads`, while the tile click would use
  // `notfair-metaads`. Treat as an idempotent re-pick: return the
  // existing key so the connect chain reuses it instead of writing a
  // duplicate row.
  const existingByUrl = findUserMcpServerByResourceUrl(
    project.slug,
    input.resource_url,
  );
  if (existingByUrl) {
    return { ok: true, key: existingByUrl.key };
  }