Skip to content

πŸ“¨ The ultimate agentic social media scheduling tool πŸ€–

feat: better onboarding

Nevo David4f296fc09001
diff --git a/apps/frontend/src/components/onboarding/onboarding.modal.tsx b/apps/frontend/src/components/onboarding/onboarding.modal.tsx
index 607691592..09ff8d7bd 100644
--- a/apps/frontend/src/components/onboarding/onboarding.modal.tsx
+++ b/apps/frontend/src/components/onboarding/onboarding.modal.tsx
@@ -1,6 +1,6 @@
'use client';
-import React, { FC, useCallback, useMemo, useState } from 'react';
+import React, { FC, Fragment, useCallback, useMemo, useState } from 'react';
import { useFetch } from '@gitroom/helpers/utils/custom.fetch';
import useSWR from 'swr';
import { orderBy } from 'lodash';
@@ -9,6 +9,17 @@ import SafeImage from '@gitroom/react/helpers/safe.image';
import { AddProviderComponent } from '@gitroom/frontend/components/launches/add.provider.component';
import { useT } from '@gitroom/react/translation/get.transation.service.client';
import { useModals } from '@gitroom/frontend/components/layout/new-modal';
+import { useUser } from '@gitroom/frontend/components/layout/user.context';
+import { useVariables } from '@gitroom/react/helpers/variable.context';
+import {
+ CopyButton,
+ getMcpConfig,
+ getMcpOauthUrl,
+ isChatOnlyMcpClient,
+ localCliSteps,
+ McpAuth,
+} from '@gitroom/frontend/components/public-api/public.component';
+import { McpClientIcon } from '@gitroom/frontend/components/public-api/mcp.client.icons';
interface OnboardingModalProps {
onClose: () => void;
@@ -19,11 +30,18 @@ export const OnboardingModal: FC<OnboardingModalProps> = ({ onClose }) => {
const modals = useModals();
const t = useT();
+ const steps = useMemo(
+ () => [
+ t('connect_channels', 'Connect Channels'),
+ t('connect_agents', 'Connect Agents'),
+ t('watch_tutorial', 'Watch Tutorial'),
+ ],
+ [t]
+ );
+
return (
- <div className="w-full min-h-full flex-1 p-[40px] flex relative">
- <style>
- {`#support-discord {display: none}`}
- </style>
+ <div className="w-full min-h-full flex-1 p-[24px] flex relative">
+ <style>{`#support-discord {display: none}`}</style>
<div className="flex flex-1 bg-newBgColorInner rounded-[20px] flex-col relative">
<button
className="outline-none absolute end-[20px] top-[20px] mantine-UnstyledButton-root mantine-ActionIcon-root hover:bg-tableBorder cursor-pointer mantine-Modal-close mantine-1dcetaa"
@@ -45,51 +63,37 @@ export const OnboardingModal: FC<OnboardingModalProps> = ({ onClose }) => {
></path>
</svg>
</button>
- <div className="flex-1 flex p-[40px]">
+ <div className="flex-1 flex p-[32px]">
<div className="flex flex-col gap-[24px] flex-1">
{/* Step indicators */}
<div className="flex items-center justify-center gap-[16px]">
- <div className="flex items-center gap-[8px]">
- <div
- className={clsx(
- 'w-[32px] h-[32px] rounded-full flex items-center justify-center text-[14px] font-semibold transition-colors',
- step === 1
- ? 'bg-boxFocused text-textItemFocused'
- : 'bg-newTableHeader'
- )}
- >
- 1
- </div>
- <span
- className={clsx(
- 'text-[14px]',
- step === 1 ? 'font-medium' : 'text-textColor'
- )}
- >
- {t('connect_channels', 'Connect Channels')}
- </span>
- </div>
- <div className="w-[40px] h-[2px] bg-boxFocused" />
- <div className="flex items-center gap-[8px]">
- <div
- className={clsx(
- 'w-[32px] h-[32px] rounded-full flex items-center justify-center text-[14px] font-semibold transition-colors',
- step === 2
- ? 'bg-boxFocused text-textItemFocused'
- : 'bg-newTableHeader'
+ {steps.map((label, index) => (
+ <Fragment key={label}>
+ {index > 0 && (
+ <div className="w-[40px] h-[2px] bg-boxFocused" />
)}
- >
- 2
- </div>
- <span
- className={clsx(
- 'text-[14px]',
- step === 2 ? 'font-medium' : 'text-textColor'
- )}
- >
- {t('watch_tutorial', 'Watch Tutorial')}
- </span>
- </div>
+ <div className="flex items-center gap-[8px]">
+ <div
+ className={clsx(
+ 'w-[32px] h-[32px] rounded-full flex items-center justify-center text-[14px] font-semibold transition-colors',
+ step === index + 1
+ ? 'bg-boxFocused text-textItemFocused'
+ : 'bg-newTableHeader'
+ )}
+ >
+ {index + 1}
+ </div>
+ <span
+ className={clsx(
+ 'text-[14px]',
+ step === index + 1 ? 'font-medium' : 'text-textColor'
+ )}
+ >
+ {label}
+ </span>
+ </div>
+ </Fragment>
+ ))}
</div>
{/* Step content */}
@@ -100,7 +104,13 @@ export const OnboardingModal: FC<OnboardingModalProps> = ({ onClose }) => {
/>
)}
{step === 2 && (
- <OnboardingStep2 onBack={() => setStep(1)} onFinish={onClose} />
+ <OnboardingStep2
+ onBack={() => setStep(1)}
+ onNext={() => setStep(3)}
+ />
+ )}
+ {step === 3 && (
+ <OnboardingStep3 onBack={() => setStep(2)} onFinish={onClose} />
)}
</div>
</div>
@@ -240,7 +250,409 @@ const OnboardingStep1: FC<{ onNext: () => void; onSkip: () => void }> = ({
);
};
-const OnboardingStep2: FC<{ onBack: () => void; onFinish: () => void }> = ({
+const onboardingAgents = [
+ 'Claude',
+ 'ChatGPT',
+ 'Claude Code',
+ 'Cursor',
+ 'Codex',
+ 'Grok Bot',
+] as const;
+
+type OnboardingAgent = (typeof onboardingAgents)[number];
+
+// Not an agent, a tab showing the raw API key for people integrating by hand
+const apiTab = 'API' as const;
+type OnboardingTab = OnboardingAgent | typeof apiTab;
+
+const cliCommands = localCliSteps.map((step) => step.code);
+
+// Cursor one-click install: https://cursor.com/docs/mcp/install-links
+const getCursorInstallUrl = (
+ auth: McpAuth,
+ mcpBase: string,
+ apiKey: string
+) => {
+ const server =
+ auth === 'oauth'
+ ? { url: getMcpOauthUrl(mcpBase) }
+ : {
+ url: `${mcpBase}/mcp`,
+ headers: { Authorization: `Bearer ${apiKey}` },
+ };
+ return `cursor://anysphere.cursor-deeplink/mcp/install?name=postiz&config=${btoa(
+ JSON.stringify(server)
+ )}`;
+};
+
+const OnboardingStep2: FC<{ onBack: () => void; onNext: () => void }> = ({
+ onBack,
+ onNext,
+}) => {
+ const t = useT();
+ const user = useUser();
+ const { backendUrl, mcpUrl, billingEnabled } = useVariables();
+ const [agent, setAgent] = useState<OnboardingTab>('Claude');
+ const [auth, setAuth] = useState<McpAuth>('oauth');
+ const [revealed, setRevealed] = useState(false);
+ const mcpBase = mcpUrl || backendUrl;
+ const apiKey = user?.publicApi || '';
+ const available = !!apiKey && !!user?.tier?.public_api;
+
+ const { config, hint } =
+ agent === apiTab
+ ? { config: '', hint: '' }
+ : getMcpConfig(agent, auth, mcpBase, apiKey);
+
+ const maskedConfig =
+ revealed || auth === 'oauth' || !apiKey
+ ? config
+ : config.replace(
+ new RegExp(apiKey.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'),
+ '*'.repeat(apiKey.length)
+ );
+
+ const connector =
+ agent === 'Claude' && billingEnabled
+ ? {
+ href: 'https://claude.ai/directory/postiz',
+ label: t('add_to_claude', 'Add to Claude'),
+ }
+ : agent === 'Cursor'
+ ? {
+ href: getCursorInstallUrl(auth, mcpBase, apiKey),
+ label: t('add_to_cursor', 'Add to Cursor'),
+ }
+ : null;
+
+ const maskedApiKey = revealed ? apiKey : '*'.repeat(apiKey.length);
+
+ const chatSection = (
+ <div className="bg-newBgColorInnerInner rounded-[12px] border border-newBorder overflow-hidden">
+ <div className="bg-newBgColorInner px-[20px] py-[14px] border-b border-newBorder">
+ <div className="text-[15px] font-[600]">{t('chat', 'Chat')}</div>
+ <div className="text-[13px] text-customColor18 mt-[2px]">
+ {t(
+ 'chat_onboarding_description',
+ 'No MCP or CLI settings needed. Paste this into the chat, the agent installs the Postiz CLI and asks you for your API key.'
+ )}
+ </div>
+ </div>
+ <div className="p-[20px] flex flex-col gap-[16px]">
+ <div className="flex flex-col gap-[8px]">
+ <pre className="bg-newBgColorInner border border-newBorder rounded-[8px] p-[12px] text-[12px] whitespace-pre-wrap break-all overflow-x-auto leading-[1.5]">
+ {config}
+ </pre>
+ <div className="flex gap-[8px]">
+ <CopyButton text={config} label={t('copy', 'Copy')} />
+ </div>
+ </div>
+ <div className="flex flex-col gap-[8px]">
+ <div className="text-[13px] font-[600] text-customColor18">
+ {t('api_key', 'API Key')}
+ </div>
+ <pre className="bg-newBgColorInner border border-newBorder rounded-[8px] p-[12px] text-[12px] whitespace-pre-wrap break-all overflow-x-auto leading-[1.5]">
+ {maskedApiKey}
+ </pre>
+ <div className="flex gap-[8px]">
+ <button
+ type="button"
+ onClick={() => setRevealed(!revealed)}
+ className="cursor-pointer px-[16px] h-[36px] bg-btnSimple hover:bg-boxHover transition-colors rounded-[8px] text-[13px] font-[600] flex items-center gap-[6px]"
+ >
+ {revealed ? t('hide', 'Hide') : t('reveal', 'Reveal')}
+ </button>
+ <CopyButton text={apiKey} label={t('copy', 'Copy')} />
+ </div>
+ </div>
+ </div>
+ </div>
+ );
+
+ const apiSection = (
+ <>
+ <div className="bg-newBgColorInnerInner rounded-[12px] border border-newBorder px-[20px] py-[14px] flex items-center justify-between gap-[12px]">
+ <div>
+ <div className="text-[15px] font-[600]">
+ {t('documentation', 'Documentation')}
+ </div>
+ <div className="text-[13px] text-customColor18 mt-[2px]">
+ {t(
+ 'api_onboarding_description',
+ 'Use the Postiz API from your own code, n8n or any other automation'
+ )}
+ </div>
+ </div>
+ <a
+ className="cursor-pointer px-[24px] h-[44px] bg-[#612BD3] hover:bg-[#5520CB] text-white transition-colors rounded-[8px] text-[14px] font-[600] flex items-center gap-[8px] shrink-0"
+ href="https://docs.postiz.com/public-api/introduction"
+ target="_blank"
+ >
+ <McpClientIcon client={apiTab} size={18} />
+ {t('read_the_api_docs', 'Read the API docs')}
+ </a>
+ </div>
+ <div className="bg-newBgColorInnerInner rounded-[12px] border border-newBorder overflow-hidden">
+ <div className="bg-newBgColorInner px-[20px] py-[14px] border-b border-newBorder">
+ <div className="text-[15px] font-[600]">
+ {t('api_key', 'API Key')}
+ </div>
+ <div className="text-[13px] text-customColor18 mt-[2px]">
+ {t(
+ 'api_key_onboarding_description',
+ 'Send it as the Authorization header on every request'
+ )}
+ </div>
+ </div>
+ <div className="p-[20px] flex flex-col gap-[8px]">
+ <pre className="bg-newBgColorInner border border-newBorder rounded-[8px] p-[12px] text-[12px] whitespace-pre-wrap break-all overflow-x-auto leading-[1.5]">
+ {maskedApiKey}
+ </pre>
+ <div className="flex gap-[8px]">
+ <button
+ type="button"
+ onClick={() => setRevealed(!revealed)}
+ className="cursor-pointer px-[16px] h-[36px] bg-btnSimple hover:bg-boxHover transition-colors rounded-[8px] text-[13px] font-[600] flex items-center gap-[6px]"
+ >
+ {revealed ? t('hide', 'Hide') : t('reveal', 'Reveal')}
+ </button>
+ <CopyButton text={apiKey} label={t('copy', 'Copy')} />
+ </div>
+ </div>
+ </div>
+ </>
+ );
+
+ const connectorSection = connector && (
+ <div className="bg-newBgColorInnerInner rounded-[12px] border border-newBorder px-[20px] py-[14px] flex items-center justify-between gap-[12px]">
+ <div>
+ <div className="text-[15px] font-[600]">
+ {t('connector', 'Connector')}
+ </div>
+ <div className="text-[13px] text-customColor18 mt-[2px]">
+ {t(
+ 'connector_onboarding_description',
+ 'The fastest way: add Postiz with one click, you will be asked to sign in'
+ )}
+ </div>
+ </div>
+ <a
+ className="cursor-pointer px-[24px] h-[44px] bg-[#612BD3] hover:bg-[#5520CB] text-white transition-colors rounded-[8px] text-[14px] font-[600] flex items-center gap-[8px] shrink-0"
+ href={connector.href}
+ target="_blank"
+ >
+ <McpClientIcon client={agent} size={18} />
+ {connector.label}
+ </a>
+ </div>
+ );
+
+ const mcpSection = (
+ <div className="bg-newBgColorInnerInner rounded-[12px] border border-newBorder overflow-hidden flex flex-col">
+ <div className="bg-newBgColorInner px-[20px] py-[14px] border-b border-newBorder">
+ <div className="text-[15px] font-[600]">{t('mcp', 'MCP')}</div>
+ <div className="text-[13px] text-customColor18 mt-[2px]">
+ {t(
+ 'mcp_onboarding_description',
+ 'Give your agent Postiz tools to create, schedule and manage posts'
+ )}
+ </div>
+ </div>
+ <div className="p-[20px] flex flex-col gap-[16px] flex-1">
+ <div className="flex flex-col gap-[6px]">
+ <div className="text-[13px] font-[600] text-customColor18">
+ {t('auth_method', 'Authentication')}
+ </div>
+ <div className="flex gap-[6px]">
+ {(['oauth', 'apikey'] as const).map((m) => (
+ <button
+ key={m}
+ type="button"
+ className={clsx(
+ 'cursor-pointer px-[14px] h-[36px] text-[13px] font-[500] rounded-[8px] transition-colors',
+ auth === m
+ ? 'bg-[#612BD3] text-white'
+ : 'bg-btnSimple text-customColor18 hover:bg-boxHover hover:text-textColor'
+ )}
+ onClick={() => setAuth(m)}
+ >
+ {m === 'oauth'
+ ? t('sign_in_no_api_key', 'Sign in with Postiz (no API key)')
+ : t('api_key', 'API Key')}
+ </button>
+ ))}
+ </div>
+ </div>
+ <div className="flex flex-col gap-[8px]">
+ <div className="text-[12px] text-customColor18 font-[500]">
+ {hint}
+ {auth === 'oauth' &&
+ ` ${t(
+ 'oauth_sign_in_hint',
+ 'Your agent will open a browser window to sign in to Postiz.'
+ )}`}
+ </div>
+ <pre className="bg-newBgColorInner border border-newBorder rounded-[8px] p-[12px] text-[12px] whitespace-pre-wrap break-all overflow-x-auto leading-[1.5]">
+ {maskedConfig}
+ </pre>
+ <div className="flex gap-[8px]">
+ {auth === 'apikey' && (
+ <button
+ type="button"
+ onClick={() => setRevealed(!revealed)}
+ className="cursor-pointer px-[16px] h-[36px] bg-btnSimple hover:bg-boxHover transition-colors rounded-[8px] text-[13px] font-[600] flex items-center gap-[6px]"
+ >
+ {revealed ? t('hide', 'Hide') : t('reveal', 'Reveal')}
+ </button>
+ )}
+ <CopyButton text={config} label={t('copy', 'Copy')} />
+ </div>
+ </div>
+ </div>
+ </div>
+ );
+
+ const cliSection = (
+ <div className="bg-newBgColorInnerInner rounded-[12px] border border-newBorder overflow-hidden flex flex-col">
+ <div className="bg-newBgColorInner px-[20px] py-[14px] border-b border-newBorder">
+ <div className="text-[15px] font-[600]">{t('cli', 'CLI')}</div>
+ <div className="text-[13px] text-customColor18 mt-[2px]">
+ {t(
+ 'cli_onboarding_description',
+ 'Install the Postiz CLI and the skill that teaches your agent how to use it'
+ )}
+ </div>
+ </div>
+ <div className="p-[20px] flex flex-col gap-[8px] flex-1">
+ <pre className="bg-newBgColorInner border border-newBorder rounded-[8px] p-[12px] text-[12px] whitespace-pre-wrap break-all overflow-x-auto leading-[1.5] flex-1">
+ {cliCommands.join('\n')}
+ </pre>
+ <div className="flex gap-[8px]">
+ <CopyButton
+ text={cliCommands.join(' && ')}
+ label={t('copy', 'Copy')}
+ />
+ </div>
+ </div>
+ </div>
+ );
+
+ return (
+ <div className="flex flex-col gap-[24px] flex-1">
+ <div className="flex gap-[4px] flex-col text-center">
+ <div className="text-[24px] font-semibold">
+ {t('connect_your_ai_agent', 'Connect Your AI Agent')}
+ </div>
+ <div className="text-[14px] text-customColor18">
+ {t(
+ 'connect_agent_description',
+ 'Pick the agent you use and let it create and schedule posts for you'
+ )}
+ </div>
+ </div>
+
+ {available ? (
+ <div className="flex flex-col gap-[16px] w-full max-w-[1100px] mx-auto">
+ <div className="flex flex-wrap justify-center gap-[6px]">
+ {[...onboardingAgents, apiTab].map((item) => (
+ <button
+ key={item}
+ type="button"
+ className={clsx(
+ 'cursor-pointer px-[14px] h-[36px] text-[13px] font-[500] rounded-[8px] transition-colors flex items-center gap-[8px]',
+ agent === item
+ ? 'bg-[#612BD3] text-white'
+ : item === apiTab
+ ? 'bg-btnSimple text-[#a78bfa] hover:bg-boxHover hover:text-[#c4b5fd]'
+ : 'bg-btnSimple text-customColor18 hover:bg-boxHover hover:text-textColor'
+ )}
+ onClick={() => setAgent(item)}
+ >
+ <McpClientIcon client={item} />
+ {item}
+ </button>
+ ))}
+ </div>
+
+ {agent === apiTab ? (
+ apiSection
+ ) : isChatOnlyMcpClient(agent) ? (
+ chatSection
+ ) : (
+ <>
+ {connectorSection}
+ <div className="grid grid-cols-2 gap-[16px]">
+ {mcpSection}
+ {cliSection}
+ </div>
+ </>
+ )}
+ </div>
+ ) : (
+ <div className="bg-newTableHeader rounded-[8px] p-[16px] text-[14px] text-customColor18 text-center w-full max-w-[860px] mx-auto">
+ {t(
+ 'agent_access_unavailable',
+ 'Agent access is not available for your current plan or role. You can set it up later under Settings > Developers.'
+ )}
+ </div>
+ )}
+
+ {/* Action buttons */}
+ <div className="flex justify-between items-center pt-[8px] mt-auto w-full max-w-[1100px] mx-auto">
+ <button
+ onClick={onBack}
+ className="group flex items-center gap-[8px] bg-transparent border-2 border-boxFocused font-medium px-[24px] py-[12px] rounded-[12px] text-[15px] transition-all"
+ >
+ <svg
+ xmlns="http://www.w3.org/2000/svg"
+ width="18"
+ height="18"
+ viewBox="0 0 24 24"
+ fill="none"
+ stroke="currentColor"
+ strokeWidth="2"
+ strokeLinecap="round"
+ strokeLinejoin="round"
+ className="group-hover:-translate-x-1 transition-transform"
+ >
+ <path d="m12 19-7-7 7-7" />
+ <path d="M19 12H5" />
+ </svg>
+ {t('back', 'Back')}
+ </button>
+ <div className="text-[13px] text-customColor18 text-center">
+ {t(
+ 'agent_settings_later',
+ 'More agents and full instructions are available under Settings > Developers'
+ )}
+ </div>
+ <button
+ onClick={onNext}
+ className="group flex items-center gap-[12px] bg-gradient-to-r from-[#622aff] to-[#8b5cf6] hover:from-[#7c3aff] hover:to-[#9d6eff] text-white font-semibold px-[32px] py-[14px] rounded-[12px] text-[16px] transition-all shadow-lg shadow-purple-500/25 hover:shadow-purple-500/40"
+ >
+ {t('continue_skip', 'Continue / Skip')}
+ <svg
+ xmlns="http://www.w3.org/2000/svg"
+ width="20"
+ height="20"
+ viewBox="0 0 24 24"
+ fill="none"
+ stroke="currentColor"
+ strokeWidth="2"
+ strokeLinecap="round"
+ strokeLinejoin="round"
+ className="group-hover:translate-x-1 transition-transform"
+ >
+ <path d="M5 12h14" />
+ <path d="m12 5 7 7-7 7" />
+ </svg>
+ </button>
+ </div>
+ </div>
+ );
+};
+
+const OnboardingStep3: FC<{ onBack: () => void; onFinish: () => void }> = ({
onBack,
onFinish,
}) => {
diff --git a/apps/frontend/src/components/public-api/mcp.client.icons.tsx b/apps/frontend/src/components/public-api/mcp.client.icons.tsx
new file mode 100644
index 000000000..42daa3278
--- /dev/null
+++ b/apps/frontend/src/components/public-api/mcp.client.icons.tsx
@@ -0,0 +1,453 @@
+'use client';
+
+import { FC } from 'react';
+
+// Logos for the MCP clients shown in Settings > Developers and in onboarding.
+// Monochrome marks use currentColor so they follow the button text color,
+// brand marks (Claude, VS Code, Gemini) keep their colors.
+const icons: Record<string, FC<{ size: number }>> = {
+ Claude: ({ size }) => (
+ <svg
+ width={size}
+ height={size}
+ viewBox="0 0 256 257"
+ xmlns="http://www.w3.org/2000/svg"
+ >
+ <path
+ fill="#D97757"
+ d="m50.228 170.321 50.357-28.257.843-2.463-.843-1.361h-2.462l-8.426-.518-28.775-.778-24.952-1.037-24.175-1.296-6.092-1.297L0 125.796l.583-3.759 5.12-3.434 7.324.648 16.202 1.101 24.304 1.685 17.629 1.037 26.118 2.722h4.148l.583-1.685-1.426-1.037-1.101-1.037-25.147-17.045-27.22-18.017-14.258-10.37-7.713-5.25-3.888-4.925-1.685-10.758 7-7.713 9.397.649 2.398.648 9.527 7.323 20.35 15.75L94.817 91.9l3.889 3.24 1.555-1.102.195-.777-1.75-2.917-14.453-26.118-15.425-26.572-6.87-11.018-1.814-6.61c-.648-2.723-1.102-4.991-1.102-7.778l7.972-10.823L71.42 0 82.05 1.426l4.472 3.888 6.61 15.101 10.694 23.786 16.591 32.34 4.861 9.592 2.592 8.879.973 2.722h1.685v-1.556l1.36-18.211 2.528-22.36 2.463-28.776.843-8.1 4.018-9.722 7.971-5.25 6.222 2.981 5.12 7.324-.713 4.73-3.046 19.768-5.962 30.98-3.889 20.739h2.268l2.593-2.593 10.499-13.934 17.628-22.036 7.778-8.749 9.073-9.657 5.833-4.601h11.018l8.1 12.055-3.628 12.443-11.342 14.388-9.398 12.184-13.48 18.147-8.426 14.518.778 1.166 2.01-.194 30.46-6.481 16.462-2.982 19.637-3.37 8.88 4.148.971 4.213-3.5 8.62-20.998 5.184-24.628 4.926-36.682 8.685-.454.324.519.648 16.526 1.555 7.065.389h17.304l32.21 2.398 8.426 5.574 5.055 6.805-.843 5.184-12.962 6.611-17.498-4.148-40.83-9.721-14-3.5h-1.944v1.167l11.666 11.406 21.387 19.314 26.767 24.887 1.36 6.157-3.434 4.86-3.63-.518-23.526-17.693-9.073-7.972-20.545-17.304h-1.36v1.814l4.73 6.935 25.017 37.59 1.296 11.536-1.814 3.76-6.481 2.268-7.13-1.297-14.647-20.544-15.1-23.138-12.185-20.739-1.49.843-7.194 77.448-3.37 3.953-7.778 2.981-6.48-4.925-3.436-7.972 3.435-15.749 4.148-20.544 3.37-16.333 3.046-20.285 1.815-6.74-.13-.454-1.49.194-15.295 20.999-23.267 31.433-18.406 19.702-4.407 1.75-7.648-3.954.713-7.064 4.277-6.286 25.47-32.405 15.36-20.092 9.917-11.6-.065-1.686h-.583L44.07 198.125l-12.055 1.555-5.185-4.86.648-7.972 2.463-2.593 20.35-13.999-.064.065Z"
+ />
+ </svg>
+ ),
+ 'Claude Code': ({ size }) => (
+ <svg
+ width={size}
+ height={size}
+ viewBox="0 0 256 257"
+ xmlns="http://www.w3.org/2000/svg"
+ >
+ <path
+ fill="#D97757"
+ d="m50.228 170.321 50.357-28.257.843-2.463-.843-1.361h-2.462l-8.426-.518-28.775-.778-24.952-1.037-24.175-1.296-6.092-1.297L0 125.796l.583-3.759 5.12-3.434 7.324.648 16.202 1.101 24.304 1.685 17.629 1.037 26.118 2.722h4.148l.583-1.685-1.426-1.037-1.101-1.037-25.147-17.045-27.22-18.017-14.258-10.37-7.713-5.25-3.888-4.925-1.685-10.758 7-7.713 9.397.649 2.398.648 9.527 7.323 20.35 15.75L94.817 91.9l3.889 3.24 1.555-1.102.195-.777-1.75-2.917-14.453-26.118-15.425-26.572-6.87-11.018-1.814-6.61c-.648-2.723-1.102-4.991-1.102-7.778l7.972-10.823L71.42 0 82.05 1.426l4.472 3.888 6.61 15.101 10.694 23.786 16.591 32.34 4.861 9.592 2.592 8.879.973 2.722h1.685v-1.556l1.36-18.211 2.528-22.36 2.463-28.776.843-8.1 4.018-9.722 7.971-5.25 6.222 2.981 5.12 7.324-.713 4.73-3.046 19.768-5.962 30.98-3.889 20.739h2.268l2.593-2.593 10.499-13.934 17.628-22.036 7.778-8.749 9.073-9.657 5.833-4.601h11.018l8.1 12.055-3.628 12.443-11.342 14.388-9.398 12.184-13.48 18.147-8.426 14.518.778 1.166 2.01-.194 30.46-6.481 16.462-2.982 19.637-3.37 8.88 4.148.971 4.213-3.5 8.62-20.998 5.184-24.628 4.926-36.682 8.685-.454.324.519.648 16.526 1.555 7.065.389h17.304l32.21 2.398 8.426 5.574 5.055 6.805-.843 5.184-12.962 6.611-17.498-4.148-40.83-9.721-14-3.5h-1.944v1.167l11.666 11.406 21.387 19.314 26.767 24.887 1.36 6.157-3.434 4.86-3.63-.518-23.526-17.693-9.073-7.972-20.545-17.304h-1.36v1.814l4.73 6.935 25.017 37.59 1.296 11.536-1.814 3.76-6.481 2.268-7.13-1.297-14.647-20.544-15.1-23.138-12.185-20.739-1.49.843-7.194 77.448-3.37 3.953-7.778 2.981-6.48-4.925-3.436-7.972 3.435-15.749 4.148-20.544 3.37-16.333 3.046-20.285 1.815-6.74-.13-.454-1.49.194-15.295 20.999-23.267 31.433-18.406 19.702-4.407 1.75-7.648-3.954.713-7.064 4.277-6.286 25.47-32.405 15.36-20.092 9.917-11.6-.065-1.686h-.583L44.07 198.125l-12.055 1.555-5.185-4.86.648-7.972 2.463-2.593 20.35-13.999-.064.065Z"
+ />
+ </svg>
+ ),
+ ChatGPT: ({ size }) => (
+ <svg
+ width={size}
+ height={size}
+ viewBox="0 0 256 260"
+ xmlns="http://www.w3.org/2000/svg"
+ fill="currentColor"
+ >
+ <path d="M239.184 106.203a64.716 64.716 0 0 0-5.576-53.103C219.452 28.459 191 15.784 163.213 21.74A65.586 65.586 0 0 0 52.096 45.22a64.716 64.716 0 0 0-43.23 31.36c-14.31 24.602-11.061 55.634 8.033 76.74a64.665 64.665 0 0 0 5.525 53.102c14.174 24.65 42.644 37.324 70.446 31.36a64.72 64.72 0 0 0 48.754 21.744c28.481.025 53.714-18.361 62.414-45.481a64.767 64.767 0 0 0 43.229-31.36c14.137-24.558 10.875-55.423-8.083-76.483Zm-97.56 136.338a48.397 48.397 0 0 1-31.105-11.255l1.535-.87 51.67-29.825a8.595 8.595 0 0 0 4.247-7.367v-72.85l21.845 12.636c.218.111.37.32.409.563v60.367c-.056 26.818-21.783 48.545-48.601 48.601Zm-104.466-44.61a48.345 48.345 0 0 1-5.781-32.589l1.534.921 51.722 29.826a8.339 8.339 0 0 0 8.441 0l63.181-36.425v25.221a.87.87 0 0 1-.358.665l-52.335 30.184c-23.257 13.398-52.97 5.431-66.404-17.803ZM23.549 85.38a48.499 48.499 0 0 1 25.58-21.333v61.39a8.288 8.288 0 0 0 4.195 7.316l62.874 36.272-21.845 12.636a.819.819 0 0 1-.767 0L41.353 151.53c-23.211-13.454-31.171-43.144-17.804-66.405v.256Zm179.466 41.695-63.08-36.63L161.73 77.86a.819.819 0 0 1 .768 0l52.233 30.184a48.6 48.6 0 0 1-7.316 87.635v-61.391a8.544 8.544 0 0 0-4.4-7.213Zm21.742-32.69-1.535-.922-51.619-30.081a8.39 8.39 0 0 0-8.492 0L99.98 99.808V74.587a.716.716 0 0 1 .307-.665l52.233-30.133a48.652 48.652 0 0 1 72.236 50.391v.205ZM88.061 139.097l-21.845-12.585a.87.87 0 0 1-.41-.614V65.685a48.652 48.652 0 0 1 79.757-37.346l-1.535.87-51.67 29.825a8.595 8.595 0 0 0-4.246 7.367l-.051 72.697Zm11.868-25.58 28.138-16.217 28.188 16.218v32.434l-28.086 16.218-28.188-16.218-.052-32.434Z" />
+ </svg>
+ ),
+ 'Grok Bot': ({ size }) => (
+ <svg
+ width={size}
+ height={size}
+ viewBox="-15 -15 259 259"
+ xmlns="http://www.w3.org/2000/svg"
+ fill="currentColor"
+ >
+ <mask
+ id="mcp-grokbot-eyes"
+ maskUnits="userSpaceOnUse"
+ x="-15"
+ y="-15"
+ width="259"
+ height="259"
+ >
+ <rect x="-15" y="-15" width="259" height="259" fill="white" />
+ <path
+ fill="black"
+ d="M130.36 45.98L132.71 46.19L134.98 46.81L137.11 47.83L138.97 49.28L140.47 51.09L141.68 53.12L142.73 55.23L143.76 57.36L144.78 59.49L145.79 61.62L146.79 63.76L147.76 65.91L148.71 68.07L149.63 70.25L150.52 72.43L151.37 74.63L151.99 76.91L152.10 79.26L151.64 81.57L150.59 83.68L149.04 85.45L147.10 86.78L144.90 87.62L142.56 87.93L140.22 87.71L137.98 86.99L135.93 85.82L134.17 84.24L132.78 82.34L131.69 80.25L130.77 78.08L129.87 75.89L128.94 73.72L128.00 71.56L127.03 69.40L126.05 67.26L125.05 65.12L124.03 62.99L122.93 60.90L121.87 58.79L121.03 56.59L120.72 54.26L121.10 51.93L122.15 49.83L123.75 48.10L125.76 46.89L128.01 46.19Z"
+ />
+ <path
+ fill="black"
+ d="M176.61 37.08L178.72 37.59L180.70 38.48L182.52 39.65L184.20 41.03L185.71 42.59L187.03 44.31L188.20 46.14L189.26 48.03L190.27 49.96L191.26 51.89L192.23 53.84L193.16 55.80L194.05 57.78L194.92 59.77L195.74 61.78L196.53 63.80L197.27 65.84L197.97 67.90L198.47 70.01L198.63 72.18L198.40 74.33L197.58 76.33L195.95 77.72L193.83 78.08L191.71 77.65L189.76 76.69L188.03 75.38L186.53 73.82L185.28 72.05L184.25 70.13L183.40 68.14L182.63 66.11L181.87 64.07L181.07 62.05L180.25 60.04L179.39 58.05L178.49 56.07L177.57 54.10L176.61 52.15L175.62 50.22L174.59 48.31L173.53 46.41L172.54 44.48L171.86 42.42L171.76 40.26L172.62 38.30L174.45 37.19Z"
+ />
+ </mask>
+ <path
+ d="M228.541 114.228C228.541 130.133 225.184 145.994 218.738 160.534C212.674 174.217 203.904 186.669 193.065 196.988C155.933 232.34 99.497 238.596 55.5255 212.24C45.097 205.99 35.6851 198.072 27.7451 188.866C19.1926 178.953 12.3686 167.569 7.65781 155.351C2.60712 142.264 0 128.257 0 114.228C0 98.3219 3.35751 82.4611 9.80315 67.9215C15.8672 54.2382 24.6377 41.7862 35.4767 31.4668C72.6081 -3.88483 129.044 -10.1413 173.016 16.2153C183.444 22.4653 192.856 30.3829 200.796 39.5896C209.349 49.5018 216.173 60.8859 220.883 73.1037C225.934 86.1906 228.541 100.198 228.541 114.228Z"
+ fill="currentColor"
+ mask="url(#mcp-grokbot-eyes)"
+ />
+ </svg>
+ ),
+ Codex: ({ size }) => (
+ <svg
+ width={size}
+ height={size}
+ viewBox="0 0 24 24"
+ xmlns="http://www.w3.org/2000/svg"
+ fill="currentColor"
+ >
+ <path
+ clipRule="evenodd"
+ d="M8.086.457a6.105 6.105 0 013.046-.415c1.333.153 2.521.72 3.564 1.7a.117.117 0 00.107.029c1.408-.346 2.762-.224 4.061.366l.063.03.154.076c1.357.703 2.33 1.77 2.918 3.198.278.679.418 1.388.421 2.126a5.655 5.655 0 01-.18 1.631.167.167 0 00.04.155 5.982 5.982 0 011.578 2.891c.385 1.901-.01 3.615-1.183 5.14l-.182.22a6.063 6.063 0 01-2.934 1.851.162.162 0 00-.108.102c-.255.736-.511 1.364-.987 1.992-1.199 1.582-2.962 2.462-4.948 2.451-1.583-.008-2.986-.587-4.21-1.736a.145.145 0 00-.14-.032c-.518.167-1.04.191-1.604.185a5.924 5.924 0 01-2.595-.622 6.058 6.058 0 01-2.146-1.781c-.203-.269-.404-.522-.551-.821a7.74 7.74 0 01-.495-1.283 6.11 6.11 0 01-.017-3.064.166.166 0 00.008-.074.115.115 0 00-.037-.064 5.958 5.958 0 01-1.38-2.202 5.196 5.196 0 01-.333-1.589 6.915 6.915 0 01.188-2.132c.45-1.484 1.309-2.648 2.577-3.493.282-.188.55-.334.802-.438.286-.12.573-.22.861-.304a.129.129 0 00.087-.087A6.016 6.016 0 015.635 2.31C6.315 1.464 7.132.846 8.086.457zm-.804 7.85a.848.848 0 00-1.473.842l1.694 2.965-1.688 2.848a.849.849 0 001.46.864l1.94-3.272a.849.849 0 00.007-.854l-1.94-3.393zm5.446 6.24a.849.849 0 000 1.695h4.848a.849.849 0 000-1.696h-4.848z"
+ ></path>
+ </svg>
+ ),
+ Cursor: ({ size }) => (
+ <svg
+ width={size}
+ height={size}
+ viewBox="0 0 24 24"
+ xmlns="http://www.w3.org/2000/svg"
+ fill="currentColor"
+ >
+ <path d="M11.503.131 1.891 5.678a.84.84 0 0 0-.42.726v11.188c0 .3.162.575.42.724l9.609 5.55a1 1 0 0 0 .998 0l9.61-5.55a.84.84 0 0 0 .42-.724V6.404a.84.84 0 0 0-.42-.726L12.497.131a1.01 1.01 0 0 0-.996 0M2.657 6.338h18.55c.263 0 .43.287.297.515L12.23 22.918c-.062.107-.229.064-.229-.06V12.335a.59.59 0 0 0-.295-.51l-9.11-5.257c-.109-.063-.064-.23.061-.23" />
+ </svg>
+ ),
+ 'VS Code / Copilot': ({ size }) => (
+ <svg
+ width={size}
+ height={size}
+ viewBox="0 0 100 100"
+ xmlns="http://www.w3.org/2000/svg"
+ >
+ <mask
+ id="vscode-a"
+ width="100"
+ height="100"
+ x="0"
+ y="0"
+ maskUnits="userSpaceOnUse"
+ >
+ <path
+ fill="#fff"
+ fillRule="evenodd"
+ d="M70.912 99.317a6.223 6.223 0 0 0 4.96-.19l20.589-9.907A6.25 6.25 0 0 0 100 83.587V16.413a6.25 6.25 0 0 0-3.54-5.632L75.874.874a6.226 6.226 0 0 0-7.104 1.21L29.355 38.04 12.187 25.01a4.162 4.162 0 0 0-5.318.236l-5.506 5.009a4.168 4.168 0 0 0-.004 6.162L16.247 50 1.36 63.583a4.168 4.168 0 0 0 .004 6.162l5.506 5.01a4.162 4.162 0 0 0 5.318.236l17.168-13.032L68.77 97.917a6.217 6.217 0 0 0 2.143 1.4ZM75.015 27.3 45.11 50l29.906 22.701V27.3Z"
+ clipRule="evenodd"
+ />
+ </mask>
+ <g mask="url(#vscode-a)">
+ <path
+ fill="#0065A9"
+ d="M96.461 10.796 75.857.876a6.23 6.23 0 0 0-7.107 1.207l-67.451 61.5a4.167 4.167 0 0 0 .004 6.162l5.51 5.009a4.167 4.167 0 0 0 5.32.236l81.228-61.62c2.725-2.067 6.639-.124 6.639 3.297v-.24a6.25 6.25 0 0 0-3.539-5.63Z"
+ />
+ <g filter="url(#vscode-b)">
+ <path
+ fill="#007ACC"
+ d="m96.461 89.204-20.604 9.92a6.229 6.229 0 0 1-7.107-1.207l-67.451-61.5a4.167 4.167 0 0 1 .004-6.162l5.51-5.009a4.167 4.167 0 0 1 5.32-.236l81.228 61.62c2.725 2.067 6.639.124 6.639-3.297v.24a6.25 6.25 0 0 1-3.539 5.63Z"
+ />
+ </g>
+ <g filter="url(#vscode-c)">
+ <path
+ fill="#1F9CF0"
+ d="M75.858 99.126a6.232 6.232 0 0 1-7.108-1.21c2.306 2.307 6.25.674 6.25-2.588V4.672c0-3.262-3.944-4.895-6.25-2.589a6.232 6.232 0 0 1 7.108-1.21l20.6 9.908A6.25 6.25 0 0 1 100 16.413v67.174a6.25 6.25 0 0 1-3.541 5.633l-20.601 9.906Z"
+ />
+ </g>
+ <path
+ fill="url(#vscode-d)"
+ fillRule="evenodd"
+ d="M70.851 99.317a6.224 6.224 0 0 0 4.96-.19L96.4 89.22a6.25 6.25 0 0 0 3.54-5.633V16.413a6.25 6.25 0 0 0-3.54-5.632L75.812.874a6.226 6.226 0 0 0-7.104 1.21L29.294 38.04 12.126 25.01a4.162 4.162 0 0 0-5.317.236l-5.507 5.009a4.168 4.168 0 0 0-.004 6.162L16.186 50 1.298 63.583a4.168 4.168 0 0 0 .004 6.162l5.507 5.009a4.162 4.162 0 0 0 5.317.236L29.294 61.96l39.414 35.958a6.218 6.218 0 0 0 2.143 1.4ZM74.954 27.3 45.048 50l29.906 22.701V27.3Z"
+ clipRule="evenodd"
+ opacity=".25"
+ style={{ mixBlendMode: 'overlay' }}
+ />
+ </g>
+ <defs>
+ <filter
+ id="vscode-b"
+ width="116.727"
+ height="92.246"
+ x="-8.394"
+ y="15.829"
+ colorInterpolationFilters="sRGB"
+ filterUnits="userSpaceOnUse"
+ >
+ <feFlood floodOpacity="0" result="BackgroundImageFix" />
+ <feColorMatrix
+ in="SourceAlpha"
+ values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"
+ />
+ <feOffset />
+ <feGaussianBlur stdDeviation="4.167" />
+ <feColorMatrix values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0" />
+ <feBlend
+ in2="BackgroundImageFix"
+ mode="overlay"
+ result="effect1_dropShadow"
+ />
+ <feBlend in="SourceGraphic" in2="effect1_dropShadow" result="shape" />
+ </filter>
+ <filter
+ id="vscode-c"
+ width="47.917"
+ height="116.151"
+ x="60.417"
+ y="-8.076"
+ colorInterpolationFilters="sRGB"
+ filterUnits="userSpaceOnUse"
+ >
+ <feFlood floodOpacity="0" result="BackgroundImageFix" />
+ <feColorMatrix
+ in="SourceAlpha"
+ values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"
+ />
+ <feOffset />
+ <feGaussianBlur stdDeviation="4.167" />
+ <feColorMatrix values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0" />
+ <feBlend
+ in2="BackgroundImageFix"
+ mode="overlay"
+ result="effect1_dropShadow"
+ />
+ <feBlend in="SourceGraphic" in2="effect1_dropShadow" result="shape" />
+ </filter>
+ <linearGradient
+ id="vscode-d"
+ x1="49.939"
+ x2="49.939"
+ y1=".258"
+ y2="99.742"
+ gradientUnits="userSpaceOnUse"
+ >
+ <stop stopColor="#fff" />
+ <stop offset="1" stopColor="#fff" stopOpacity="0" />
+ </linearGradient>
+ </defs>
+ </svg>
+ ),
+ Windsurf: ({ size }) => (
+ <svg
+ width={size}
+ height={size}
+ viewBox="0 0 1024 1024"
+ xmlns="http://www.w3.org/2000/svg"
+ fill="currentColor"
+ >
+ <path d="M897.246 286.869H889.819C850.735 286.808 819.017 318.46 819.017 357.539V515.589C819.017 547.15 792.93 572.716 761.882 572.716C743.436 572.716 725.02 563.433 714.093 547.85L552.673 317.304C539.28 298.16 517.486 286.747 493.895 286.747C457.094 286.747 423.976 318.034 423.976 356.657V515.619C423.976 547.181 398.103 572.746 366.842 572.746C348.335 572.746 329.949 563.463 319.021 547.881L138.395 289.882C134.316 284.038 125.154 286.93 125.154 294.052V431.892C125.154 438.862 127.285 445.619 131.272 451.34L309.037 705.2C319.539 720.204 335.033 731.344 352.9 735.392C397.616 745.557 438.77 711.135 438.77 667.278V508.406C438.77 476.845 464.339 451.279 495.904 451.279H495.995C515.02 451.279 532.857 460.562 543.785 476.145L705.235 706.661C718.659 725.835 739.327 737.218 763.983 737.218C801.606 737.218 833.841 705.9 833.841 667.308V508.376C833.841 476.815 859.41 451.249 890.975 451.249H897.276C901.233 451.249 904.43 448.053 904.43 444.097V294.021C904.43 290.065 901.233 286.869 897.276 286.869H897.246Z" />
+ </svg>
+ ),
+ 'Gemini CLI': ({ size }) => (
+ <svg
+ width={size}
+ height={size}
+ viewBox="0 0 296 298"
+ xmlns="http://www.w3.org/2000/svg"
+ >
+ <mask
+ id="gemini-a"
+ width="296"
+ height="298"
+ x="0"
+ y="0"
+ maskUnits="userSpaceOnUse"
+ style={{ maskType: 'alpha' }}
+ >
+ <path
+ fill="#3186FF"
+ d="M141.201 4.886c2.282-6.17 11.042-6.071 13.184.148l5.985 17.37a184.004 184.004 0 0 0 111.257 113.049l19.304 6.997c6.143 2.227 6.156 10.91.02 13.155l-19.35 7.082a184.001 184.001 0 0 0-109.495 109.385l-7.573 20.629c-2.241 6.105-10.869 6.121-13.133.025l-7.908-21.296a184 184 0 0 0-109.02-108.658l-19.698-7.239c-6.102-2.243-6.118-10.867-.025-13.132l20.083-7.467A183.998 183.998 0 0 0 133.291 26.28l7.91-21.394Z"
+ />
+ </mask>
+ <g mask="url(#gemini-a)">
+ <g filter="url(#gemini-b)">
+ <ellipse cx="163" cy="149" fill="#3689FF" rx="196" ry="159" />
+ </g>
+ <g filter="url(#gemini-c)">
+ <ellipse cx="33.5" cy="142.5" fill="#F6C013" rx="68.5" ry="72.5" />
+ </g>
+ <g filter="url(#gemini-d)">
+ <ellipse cx="19.5" cy="148.5" fill="#F6C013" rx="68.5" ry="72.5" />
+ </g>
+ <g filter="url(#gemini-e)">
+ <path
+ fill="#FA4340"
+ d="M194 10.5C172 82.5 65.5 134.333 22.5 135L144-66l50 76.5Z"
+ />
+ </g>
+ <g filter="url(#gemini-f)">
+ <path
+ fill="#FA4340"
+ d="M190.5-12.5C168.5 59.5 62 111.333 19 112L140.5-89l50 76.5Z"
+ />
+ </g>
+ <g filter="url(#gemini-g)">
+ <path
+ fill="#14BB69"
+ d="M194.5 279.5C172.5 207.5 66 155.667 23 155l121.5 201 50-76.5Z"
+ />
+ </g>
+ <g filter="url(#gemini-h)">
+ <path
+ fill="#14BB69"
+ d="M196.5 320.5C174.5 248.5 68 196.667 25 196l121.5 201 50-76.5Z"
+ />
+ </g>
+ </g>
+ <defs>
+ <filter
+ id="gemini-b"
+ width="464"
+ height="390"
+ x="-69"
+ y="-46"
+ colorInterpolationFilters="sRGB"
+ filterUnits="userSpaceOnUse"
+ >
+ <feFlood floodOpacity="0" result="BackgroundImageFix" />
+ <feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" />
+ <feGaussianBlur
+ result="effect1_foregroundBlur_69_17998"
+ stdDeviation="18"
+ />
+ </filter>
+ <filter
+ id="gemini-c"
+ width="265"
+ height="273"
+ x="-99"
+ y="6"
+ colorInterpolationFilters="sRGB"
+ filterUnits="userSpaceOnUse"
+ >
+ <feFlood floodOpacity="0" result="BackgroundImageFix" />
+ <feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" />
+ <feGaussianBlur
+ result="effect1_foregroundBlur_69_17998"
+ stdDeviation="32"
+ />
+ </filter>
+ <filter
+ id="gemini-d"
+ width="265"
+ height="273"
+ x="-113"
+ y="12"
+ colorInterpolationFilters="sRGB"
+ filterUnits="userSpaceOnUse"
+ >
+ <feFlood floodOpacity="0" result="BackgroundImageFix" />
+ <feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" />
+ <feGaussianBlur
+ result="effect1_foregroundBlur_69_17998"
+ stdDeviation="32"
+ />
+ </filter>
+ <filter
+ id="gemini-e"
+ width="299.5"
+ height="329"
+ x="-41.5"
+ y="-130"
+ colorInterpolationFilters="sRGB"
+ filterUnits="userSpaceOnUse"
+ >
+ <feFlood floodOpacity="0" result="BackgroundImageFix" />
+ <feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" />
+ <feGaussianBlur
+ result="effect1_foregroundBlur_69_17998"
+ stdDeviation="32"
+ />
+ </filter>
+ <filter
+ id="gemini-f"
+ width="299.5"
+ height="329"
+ x="-45"
+ y="-153"
+ colorInterpolationFilters="sRGB"
+ filterUnits="userSpaceOnUse"
+ >
+ <feFlood floodOpacity="0" result="BackgroundImageFix" />
+ <feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" />
+ <feGaussianBlur
+ result="effect1_foregroundBlur_69_17998"
+ stdDeviation="32"
+ />
+ </filter>
+ <filter
+ id="gemini-g"
+ width="299.5"
+ height="329"
+ x="-41"
+ y="91"
+ colorInterpolationFilters="sRGB"
+ filterUnits="userSpaceOnUse"
+ >
+ <feFlood floodOpacity="0" result="BackgroundImageFix" />
+ <feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" />
+ <feGaussianBlur
+ result="effect1_foregroundBlur_69_17998"
+ stdDeviation="32"
+ />
+ </filter>
+ <filter
+ id="gemini-h"
+ width="299.5"
+ height="329"
+ x="-39"
+ y="132"
+ colorInterpolationFilters="sRGB"
+ filterUnits="userSpaceOnUse"
+ >
+ <feFlood floodOpacity="0" result="BackgroundImageFix" />
+ <feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" />
+ <feGaussianBlur
+ result="effect1_foregroundBlur_69_17998"
+ stdDeviation="32"
+ />
+ </filter>
+ </defs>
+ </svg>
+ ),
+ Warp: ({ size }) => (
+ <svg
+ width={size}
+ height={size}
+ viewBox="0 0 24 24"
+ xmlns="http://www.w3.org/2000/svg"
+ fill="currentColor"
+ >
+ <path d="M12.035 2.723h9.253A2.712 2.712 0 0 1 24 5.435v10.529a2.712 2.712 0 0 1-2.712 2.713H8.047Zm-1.681 2.6L6.766 19.677h5.598l-.399 1.6H2.712A2.712 2.712 0 0 1 0 18.565V8.036a2.712 2.712 0 0 1 2.712-2.712Z" />
+ </svg>
+ ),
+ Amp: ({ size }) => (
+ <svg
+ width={size}
+ height={size}
+ viewBox="0 0 26 26"
+ fill="none"
+ stroke="currentColor"
+ strokeWidth="2.2"
+ strokeLinecap="square"
+ strokeLinejoin="miter"
+ >
+ <polyline points="8 4 17 6.5 19.5 15.5" />
+ <polyline points="5.5 8 14.5 10.5 17 19.5" />
+ <polyline points="3 12 12 14.5 14.5 23.5" />
+ <line x1="12" y1="14.5" x2="5" y2="21.5" />
+ </svg>
+ ),
+ // Not a client: the onboarding "API" tab
+ API: ({ size }) => (
+ <svg
+ width={size}
+ height={size}
+ viewBox="0 0 24 24"
+ fill="none"
+ stroke="currentColor"
+ strokeWidth="2"
+ strokeLinecap="round"
+ strokeLinejoin="round"
+ >
+ <polyline points="16 18 22 12 16 6" />
+ <polyline points="8 6 2 12 8 18" />
+ </svg>
+ ),
+};
+
+export const McpClientIcon: FC<{ client: string; size?: number }> = ({
+ client,
+ size = 16,
+}) => {
+ const Icon = icons[client];
+ if (!Icon) {
+ return null;
+ }
+ return <Icon size={size} />;
+};
diff --git a/apps/frontend/src/components/public-api/public.component.tsx b/apps/frontend/src/components/public-api/public.component.tsx
index de8a72dea..bfc90a866 100644
--- a/apps/frontend/src/components/public-api/public.component.tsx
+++ b/apps/frontend/src/components/public-api/public.component.tsx
@@ -10,9 +10,25 @@ import { useT } from '@gitroom/react/translation/get.transation.service.client';
import { useFetch } from '@gitroom/helpers/utils/custom.fetch';
import { useDecisionModal } from '@gitroom/frontend/components/layout/new-modal';
import { DeveloperComponent } from '@gitroom/frontend/components/developer/developer.component';
+import { McpClientIcon } from '@gitroom/frontend/components/public-api/mcp.client.icons';
import clsx from 'clsx';
-const mcpClients = [
+// Remote clients can't set headers, they get a URL to paste (hint = where)
+export const remoteMcpClients = {
+ Claude:
+ 'In Claude go to Settings > Connectors > Add custom connector and paste this URL.',
+ ChatGPT:
+ 'In ChatGPT go to Settings > Connectors > Create and paste this URL.',
+} as const;
+
+// Clients with no MCP or CLI settings: you paste instructions into the chat,
+// the agent installs the CLI itself and asks you for the API key
+export const chatOnlyMcpClients = {
+ 'Grok Bot':
+ 'Install the Postiz CLI with `npm install -g postiz`, then install the Postiz skill with `npx skills add gitroomhq/postiz-agent`. Ask me for my Postiz API key and set it as the POSTIZ_API_KEY environment variable before using the CLI.',
+} as const;
+
+export const mcpClients = [
'Claude Code',
'Cursor',
'VS Code / Copilot',
@@ -23,64 +39,95 @@ const mcpClients = [
'Warp',
] as const;
-type McpClient = (typeof mcpClients)[number];
+export type RemoteMcpClient = keyof typeof remoteMcpClients;
+export type ChatOnlyMcpClient = keyof typeof chatOnlyMcpClients;
+export type McpClient = (typeof mcpClients)[number];
+export type AnyMcpClient = RemoteMcpClient | ChatOnlyMcpClient | McpClient;
+
+// oauth: no API key, the client registers itself (DCR) and the user signs in to Postiz
+// apikey: the organization API key, as a Bearer header (or inside the URL for remote clients)
+export type McpAuth = 'oauth' | 'apikey';
+
+export const getMcpOauthUrl = (mcpBase: string) =>
+ `${mcpBase}/mcp-oauth-dynamic`;
+
+export const isRemoteMcpClient = (client: string): client is RemoteMcpClient =>
+ client in remoteMcpClients;
-const getMcpConfig = (
- client: McpClient,
- method: 'header' | 'path',
+export const isChatOnlyMcpClient = (
+ client: string
+): client is ChatOnlyMcpClient => client in chatOnlyMcpClients;
+
+export const getMcpConfig = (
+ client: AnyMcpClient,
+ auth: McpAuth,
mcpBase: string,
apiKey: string
): { config: string; hint: string } => {
- const urlWithKey = `${mcpBase}/mcp/${apiKey}`;
+ if (isChatOnlyMcpClient(client)) {
+ return {
+ config: chatOnlyMcpClients[client],
+ hint: 'Paste this into the chat. The agent will ask you for your API key.',
+ };
+ }
+ if (isRemoteMcpClient(client)) {
+ return {
+ config:
+ auth === 'oauth' ? getMcpOauthUrl(mcpBase) : `${mcpBase}/mcp/${apiKey}`,
+ hint: remoteMcpClients[client],
+ };
+ }
+
+ const oauthUrl = getMcpOauthUrl(mcpBase);
const urlBase = `${mcpBase}/mcp`;
const bearer = `Bearer ${apiKey}`;
const json = (obj: object) => JSON.stringify(obj, null, 2);
- if (method === 'path') {
+ if (auth === 'oauth') {
switch (client) {
case 'Claude Code':
return {
- config: `claude mcp add postiz --transport http "${urlWithKey}"`,
+ config: `claude mcp add postiz --transport http "${oauthUrl}"`,
hint: 'Run this command in your terminal.',
};
case 'Cursor':
return {
- config: json({ mcpServers: { postiz: { url: urlWithKey } } }),
+ config: json({ mcpServers: { postiz: { url: oauthUrl } } }),
hint: 'Add to .cursor/mcp.json in your project root.',
};
case 'VS Code / Copilot':
return {
config: json({
- servers: { postiz: { type: 'http', url: urlWithKey } },
+ servers: { postiz: { type: 'http', url: oauthUrl } },
}),
hint: 'Add to .vscode/mcp.json in your project root.',
};
case 'Windsurf':
return {
config: json({
- mcpServers: { postiz: { serverUrl: urlWithKey } },
+ mcpServers: { postiz: { serverUrl: oauthUrl } },
}),
hint: 'Add to ~/.codeium/windsurf/mcp_config.json',
};
case 'Amp':
return {
- config: `amp mcp add postiz ${urlWithKey}`,
+ config: `amp mcp add postiz ${oauthUrl}`,
hint: 'Run this command in your terminal.',
};
case 'Codex':
return {
- config: `# ~/.codex/config.toml\n\n[mcp_servers.postiz]\nurl = "${urlWithKey}"`,
- hint: 'Add to ~/.codex/config.toml',
+ config: `# ~/.codex/config.toml\n\n[mcp_servers.postiz]\nurl = "${oauthUrl}"`,
+ hint: 'Add to ~/.codex/config.toml, then run: codex mcp login postiz',
};
case 'Gemini CLI':
return {
- config: json({ mcpServers: { postiz: { url: urlWithKey } } }),
+ config: json({ mcpServers: { postiz: { url: oauthUrl } } }),
hint: 'Add to ~/.gemini/settings.json',
};
case 'Warp':
return {
- config: json({ postiz: { url: urlWithKey } }),
+ config: json({ postiz: { url: oauthUrl } }),
hint: 'Settings > MCP Servers > + Add, then paste this config.',
};
}
@@ -159,7 +206,7 @@ const getMcpConfig = (
}
};
-const CopyButton = ({
+export const CopyButton = ({
text,
label,
}: {
@@ -203,27 +250,28 @@ const McpSection = ({
}) => {
const t = useT();
const { billingEnabled } = useVariables();
- const [activeClient, setActiveClient] = useState<McpClient>('Claude Code');
- const [method, setMethod] = useState<'header' | 'path'>('header');
+ const [activeClient, setActiveClient] = useState<AnyMcpClient>('Claude');
+ const [auth, setAuth] = useState<McpAuth>('oauth');
const [revealed, setRevealed] = useState(false);
const { config, hint } = getMcpConfig(
activeClient,
- method,
+ auth,
mcpBase,
user.publicApi
);
- const remoteUrl = `${mcpBase}/mcp/${user.publicApi}`;
- const cliUrl = `${mcpBase}/mcp`;
+ const baseUrl = auth === 'oauth' ? getMcpOauthUrl(mcpBase) : `${mcpBase}/mcp`;
- const maskedConfig = revealed
- ? config
- : config.replace(new RegExp(user.publicApi.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'), '*'.repeat(user.publicApi.length));
+ const chatOnly = isChatOnlyMcpClient(activeClient);
- const maskedRemoteUrl = revealed
- ? remoteUrl
- : remoteUrl.replace(user.publicApi, '*'.repeat(user.publicApi.length));
+ const maskedConfig =
+ revealed || auth === 'oauth' || chatOnly
+ ? config
+ : config.replace(
+ new RegExp(user.publicApi.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'),
+ '*'.repeat(user.publicApi.length)
+ );
return (
<div className="bg-newBgColorInnerInner rounded-[12px] border border-newBorder overflow-hidden">
@@ -261,108 +309,112 @@ const McpSection = ({
</div>
</div>
<div className="p-[20px] flex flex-col gap-[16px]">
- <div className="flex flex-col gap-[6px]">
- <div className="text-[13px] font-[600] text-customColor18">
- {t('auth_method', 'Authentication')}
- </div>
- <div className="flex gap-[6px]">
- {(['header', 'path'] as const).map((m) => (
- <button
- key={m}
- type="button"
- className={clsx(
- 'cursor-pointer px-[14px] h-[36px] text-[13px] font-[500] rounded-[8px] transition-colors',
- method === m
- ? 'bg-[#612BD3] text-white'
- : 'bg-btnSimple text-customColor18 hover:bg-boxHover hover:text-textColor'
- )}
- onClick={() => setMethod(m)}
- >
- {m === 'header'
- ? t('cli_claude_code_codex', 'CLI (Claude Code / Codex)')
- : t('remote_servers', 'Remote servers (ChatGPT, Claude)')}
- </button>
- ))}
- </div>
- </div>
- {method === 'header' && (
+ {!chatOnly && (
<div className="flex flex-col gap-[6px]">
<div className="text-[13px] font-[600] text-customColor18">
- {t('mcp_client', 'Client')}
+ {t('auth_method', 'Authentication')}
</div>
- <div className="flex flex-wrap gap-[6px]">
- {mcpClients.map((client) => (
+ <div className="flex gap-[6px]">
+ {(['oauth', 'apikey'] as const).map((m) => (
<button
- key={client}
+ key={m}
type="button"
className={clsx(
'cursor-pointer px-[14px] h-[36px] text-[13px] font-[500] rounded-[8px] transition-colors',
- activeClient === client
+ auth === m
? 'bg-[#612BD3] text-white'
: 'bg-btnSimple text-customColor18 hover:bg-boxHover hover:text-textColor'
)}
- onClick={() => setActiveClient(client)}
+ onClick={() => setAuth(m)}
>
- {client}
+ {m === 'oauth'
+ ? t('sign_in_no_api_key', 'Sign in with Postiz (no API key)')
+ : t('api_key', 'API Key')}
</button>
))}
</div>
</div>
)}
+ <div className="flex flex-col gap-[6px]">
+ <div className="text-[13px] font-[600] text-customColor18">
+ {t('mcp_client', 'Client')}
+ </div>
+ <div className="flex flex-wrap gap-[6px]">
+ {[
+ ...Object.keys(remoteMcpClients),
+ ...mcpClients,
+ ...Object.keys(chatOnlyMcpClients),
+ ].map((client) => (
+ <button
+ key={client}
+ type="button"
+ className={clsx(
+ 'cursor-pointer px-[14px] h-[36px] text-[13px] font-[500] rounded-[8px] transition-colors flex items-center gap-[8px]',
+ activeClient === client
+ ? 'bg-[#612BD3] text-white'
+ : 'bg-btnSimple text-customColor18 hover:bg-boxHover hover:text-textColor'
+ )}
+ onClick={() =>
+ setActiveClient(client as AnyMcpClient)
+ }
+ >
+ <McpClientIcon client={client} />
+ {client}
+ </button>
+ ))}
+ </div>
+ </div>
<div className="flex flex-col gap-[8px]">
<div className="text-[12px] text-customColor18 font-[500]">
- {method === 'header'
- ? hint
- : t(
- 'remote_server_url_hint',
- 'Paste this URL into your remote MCP client (ChatGPT, Claude, etc.).'
- )}
+ {hint}
+ {auth === 'oauth' &&
+ !chatOnly &&
+ ` ${t(
+ 'oauth_sign_in_hint',
+ 'Your agent will open a browser window to sign in to Postiz.'
+ )}`}
</div>
<pre className="bg-newBgColorInner border border-newBorder rounded-[8px] p-[16px] text-[13px] whitespace-pre-wrap break-all overflow-x-auto leading-[1.6]">
- {method === 'header' ? maskedConfig : maskedRemoteUrl}
+ {maskedConfig}
</pre>
<div className="flex gap-[8px]">
- <button
- type="button"
- onClick={() => setRevealed(!revealed)}
- className="cursor-pointer px-[16px] h-[36px] bg-btnSimple hover:bg-boxHover transition-colors rounded-[8px] text-[13px] font-[600] flex items-center gap-[6px]"
- >
- <svg
- width="14"
- height="14"
- viewBox="0 0 24 24"
- fill="none"
- stroke="currentColor"
- strokeWidth="2"
- strokeLinecap="round"
- strokeLinejoin="round"
+ {auth === 'apikey' && !chatOnly && (
+ <button
+ type="button"
+ onClick={() => setRevealed(!revealed)}
+ className="cursor-pointer px-[16px] h-[36px] bg-btnSimple hover:bg-boxHover transition-colors rounded-[8px] text-[13px] font-[600] flex items-center gap-[6px]"
>
- {revealed ? (
- <>
- <path d="M17.94 17.94A10.07 10.07 0 0112 20c-7 0-11-8-11-8a18.45 18.45 0 015.06-5.94" />
- <path d="M9.9 4.24A9.12 9.12 0 0112 4c7 0 11 8 11 8a18.5 18.5 0 01-2.16 3.19" />
- <line x1="1" y1="1" x2="23" y2="23" />
- </>
- ) : (
- <>
- <path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z" />
- <circle cx="12" cy="12" r="3" />
- </>
- )}
- </svg>
- {revealed ? t('hide', 'Hide') : t('reveal', 'Reveal')}
- </button>
- <CopyButton
- text={method === 'header' ? config : remoteUrl}
- label={t('copy', 'Copy')}
- />
- {method === 'header' && (
- <CopyButton
- text={cliUrl}
- label={t('copy_url', 'Copy URL')}
- />
+ <svg
+ width="14"
+ height="14"
+ viewBox="0 0 24 24"
+ fill="none"
+ stroke="currentColor"
+ strokeWidth="2"
+ strokeLinecap="round"
+ strokeLinejoin="round"
+ >
+ {revealed ? (
+ <>
+ <path d="M17.94 17.94A10.07 10.07 0 0112 20c-7 0-11-8-11-8a18.45 18.45 0 015.06-5.94" />
+ <path d="M9.9 4.24A9.12 9.12 0 0112 4c7 0 11 8 11 8a18.5 18.5 0 01-2.16 3.19" />
+ <line x1="1" y1="1" x2="23" y2="23" />
+ </>
+ ) : (
+ <>
+ <path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z" />
+ <circle cx="12" cy="12" r="3" />
+ </>
+ )}
+ </svg>
+ {revealed ? t('hide', 'Hide') : t('reveal', 'Reveal')}
+ </button>
+ )}
+ <CopyButton text={config} label={t('copy', 'Copy')} />
+ {!isRemoteMcpClient(activeClient) && !chatOnly && (
+ <CopyButton text={baseUrl} label={t('copy_url', 'Copy URL')} />
)}
- {method === 'path' && billingEnabled && (
+ {activeClient === 'Claude' && billingEnabled && (
<a
className="cursor-pointer px-[16px] h-[36px] bg-[#612BD3] hover:bg-[#5520CB] text-white transition-colors rounded-[8px] text-[13px] font-[600] flex items-center gap-[6px]"
href="https://claude.ai/directory/postiz"
@@ -379,7 +431,7 @@ const McpSection = ({
);
};
-const localCliSteps = [
+export const localCliSteps = [
{
label: 'Install the CLI',
code: 'npm install -g postiz',
diff --git a/libraries/react-shared-libraries/src/translation/locales/en/translation.json b/libraries/react-shared-libraries/src/translation/locales/en/translation.json
index 41d74ef25..912c3af22 100644
--- a/libraries/react-shared-libraries/src/translation/locales/en/translation.json
+++ b/libraries/react-shared-libraries/src/translation/locales/en/translation.json
@@ -696,10 +696,30 @@
"connected_channels": "Connected Channels",
"continue": "Continue",
"continue_without_channels": "Continue without channels",
+ "connect_agents": "Connect Agents",
+ "connect_your_ai_agent": "Connect Your AI Agent",
+ "connect_agent_description": "Pick the agent you use and let it create and schedule posts for you",
+ "agent_access_unavailable": "Agent access is not available for your current plan or role. You can set it up later under Settings > Developers.",
+ "sign_in_no_api_key": "Sign in with Postiz (no API key)",
+ "oauth_sign_in_hint": "Your agent will open a browser window to sign in to Postiz.",
+ "add_to_cursor": "Add to Cursor",
+ "cli": "CLI",
+ "documentation": "Documentation",
+ "read_the_api_docs": "Read the API docs",
+ "api_key_onboarding_description": "Send it as the Authorization header on every request",
+ "api_onboarding_description": "Use the Postiz API from your own code, n8n or any other automation",
+ "chat": "Chat",
+ "chat_onboarding_description": "No MCP or CLI settings needed. Paste this into the chat, the agent installs the Postiz CLI and asks you for your API key.",
+ "connector": "Connector",
+ "connector_onboarding_description": "The fastest way: add Postiz with one click, you will be asked to sign in",
+ "mcp_onboarding_description": "Give your agent Postiz tools to create, schedule and manage posts",
+ "cli_onboarding_description": "Install the Postiz CLI and the skill that teaches your agent how to use it",
+ "agent_settings_later": "More agents and full instructions are available under Settings > Developers",
"watch_tutorial": "Watch Tutorial",
"watch_tutorial_title": "Learn How to Use Postiz",
"watch_tutorial_description": "Watch this short video to learn how to get the most out of Postiz",
"back": "Back",
+ "continue_skip": "Continue / Skip",
"get_started": "Get Started",
"kick_select_channel": "Select Channel",
"annual": "Annual",