Skip to content

Connect Firstage to your AI app

Part ofMake with AIMake

Once you connect Firstage to an AI app, the app can read your Firstage photo details and save photobook, calendar, postcard and photo card drafts in Firstage. You add the URL below in the app’s connector settings, then sign in to Firstage and allow the connection. This shared way of letting an AI app use another service’s tools is called MCP.

Firstage connection URL

https://api.firstage.ai/mcp

Enter the whole URL, including /mcp at the end. You never need to give your AI app a Firstage password or API key.

  • You have a Firstage account, and the photos you want to use are already uploaded. An AI app can’t upload photos.
  • Your AI app and its plan let you add a connector yourself. See the table for your app below.
  • You’re signed in to your AI app in a browser on a computer. All three apps let you add the connection on the web.

The conditions for each app come from that company’s own help pages, read on . The “Evidence” column means:

  • Verified: we read it on the company’s official help page.
  • Observed: we could see only part of the official help page.
  • Unverified: we couldn’t confirm it.

Firstage hasn’t tested making a draft through Claude.ai, ChatGPT or the Gemini app itself. Menu names are from each app in English, and your screens may differ by app version and plan.

Claude plan What you can do Evidence
Every plan Use connectors you add yourself Verified
Free Add one connector of your own Verified
  1. Sign in to claude.ai in a browser on your computer.
  2. In “Customize” → “Connectors”, choose “Add custom connector”.
  3. Enter Firstage in “Name”, paste the connection URL above into the server URL field, then choose “Continue”.
  4. If Claude asks whether you trust this unverified connector, check that the address matches the connection URL above, then go on.
  5. When a Firstage page opens in your browser, sign in and allow access.
  6. Back in a Claude chat, open “+” → “Connectors” and switch on Firstage.
When the connection check brings back your list of journeys, you’re done.
  • On Team and Enterprise, an organization owner adds it first in “Organization settings” → “Connectors”. Members then choose “Connect” in “Customize” → “Connectors”.
  • A connection added on the web or in the desktop app also works in the Claude mobile app.

Depending on your ChatGPT plan, a connection may not be able to save drafts. Making a draft needs permission for Firstage to write it to your account.

ChatGPT plan What you can do Evidence
Business, Enterprise, Edu Connect and make drafts Observed
Pro Connect, but read only, so drafts can’t be saved Observed
Plus We couldn’t confirm it Unverified
Free, Go Can’t add a connector of your own Observed
  1. Sign in to ChatGPT in a browser on your computer and open chatgpt.com/plugins.
  2. Choose “+” → “Add custom MCP server”.
  3. Enter Firstage as the name and paste the connection URL above into the URL field.
  4. Choose “OAuth” for authentication. Review the tools and install it.
  5. When a Firstage page opens in your browser, sign in and allow access.
  6. In a new chat, type @ in the message box and choose Firstage.
When the connection check brings back your list of journeys, you’re done.

On Plus or Pro

The connection may work, but making drafts may not. These plans can’t upload skills either, so after connecting, paste the setup prompt into a new chat instead.

In the Gemini app, you add Firstage as a custom app. Custom apps are open only to accounts that meet every condition below.

Condition What you need Evidence
Account A personal Google account Verified
Country The US Verified
Age 18 or over Verified
Language English Verified
Gemini history Switched on Verified
  1. Sign in to gemini.google.com in a browser on your computer.
  2. Open “Settings” → “Connected Apps” → “Custom apps” → “Add a custom app”.
  3. Paste the connection URL above into the MCP server URL field.
  4. When a Firstage page opens in your browser, sign in and allow access.
When the connection check brings back your list of journeys, you’re done.
  • A connection added on the web also works in the Gemini mobile app.
  • Gemini asks you to confirm every change it makes in Firstage.

When your AI app starts connecting, a Firstage page opens in your browser.

  1. Sign in to Firstage.
  2. On the consent screen, check the name of the app asking to connect and the address it returns to.
  3. Everything under “Always included” needs no switch. Making photobook, calendar and card drafts is in it.
  4. Under “Optional permissions”, switch on only what you want to allow. Every switch starts off. Permissions explains each one.
  5. Tap “Allow”. When you see “Access allowed”, go back to your AI app.
When the app appears in Firstage under Account settings > Security and privacy > “Connected AI apps”, you’re done.

This request checks the connection without making anything yet. Paste it into your AI app’s message box and send it.

Connection check

Use Firstage to list my journeys and shared spaces. Don't create or change anything yet.

When your journeys and shared spaces come back, you’re connected. Next, choose a theme and ask for a draft.

  • Your AI app says it can’t reach Firstage. Check that the app is in your “Connected AI apps” list in Firstage. If it isn’t, connect again from your AI app.
  • Firstage’s tools don’t show up in the chat. Switch on Firstage in the chat and start a new chat. If they still don’t appear, reopen the app.
  • The sign-in page says it has expired. Start connecting again from your AI app. If you’re already signed in to Firstage, you go straight to the consent screen.
  • It connected, but no draft was saved. Your AI app’s plan may allow reading only. Check the table for your app above.

You can disconnect any time in “Connected AI apps” in Firstage. Disconnect an app has the steps and explains why removing it only in your AI app isn’t enough.

These steps are for tools you use to write code, such as Claude Code, Codex, Cursor, VS Code and Gemini CLI. Paste commands into your computer’s terminal, not a chat: Terminal on macOS, PowerShell on Windows. Commands that start with / go in the tool’s own message box.

In October 2026, Firstage tested connecting, drafting a book and applying an approved change through Claude Code in the live service. Codex was tested through signing in and reading photo details. The steps for the other tools follow each tool’s official docs.

Claude Code needs a Claude Pro, Max, Team or Enterprise plan or a Console account. Claude Free doesn’t include it.

  1. In the terminal, add the Firstage marketplace.

    Terminal window
    claude plugin marketplace add firstage-ai/skills
  2. In the same terminal, install the Firstage plugin. It installs the Firstage connection together with the skills.

    Terminal window
    claude plugin install firstage@firstage
  3. Type claude in the terminal to open Claude Code.

  4. Type /mcp in the message box, choose firstage, then choose “Authenticate”.

  5. When a Firstage page opens in your browser, sign in and allow access.

When /mcp shows firstage connected and the connection check brings back your list of journeys, you’re done.

To add only the connection, without the skills, use this one command instead of steps 1 and 2. It registers Firstage for the current folder only.

Terminal window
claude mcp add --transport http firstage https://api.firstage.ai/mcp

Codex is included in every ChatGPT plan, and its usage is shared with ChatGPT.

  1. Register Firstage in the terminal. This step doesn’t sign you in yet.

    Terminal window
    codex mcp add firstage --url https://api.firstage.ai/mcp
  2. In the same terminal, run the login command. When a Firstage page opens in your browser, sign in and allow access.

    Terminal window
    codex mcp login firstage
  3. Type codex in the terminal to open it, then type /mcp in the message box and check that firstage and its tools appear.

When the connection check brings back your list of journeys, you’re done.

If you use Codex in the ChatGPT desktop app, open “Settings” → “MCP servers” → “Add server” in a version that has MCP settings. Enter Firstage, choose “Streamable HTTP”, paste the connection URL, then choose “Authenticate” for Firstage. ChatGPT on the web doesn’t read this setting.

You need a current Cursor version with remote MCP and OAuth support. Cursor’s pricing lists MCP under Pro, and on a team you can use only the servers an administrator allows.

  1. Open .cursor/mcp.json to use it in this project only, or ~/.cursor/mcp.json for every project.

  2. Add the firstage entry below inside mcpServers. If the file already lists other servers, merge the entry rather than replacing the file.

    {
    "mcpServers": {
    "firstage": {
    "url": "https://api.firstage.ai/mcp"
    }
    }
    }
  3. Save the file and switch on Firstage in Cursor’s “Customize” screen.

  4. When a Firstage page opens in your browser, sign in and allow access.

When the connection check in an AI chat brings back your list of journeys, you’re done.

MCP is available on Copilot Free, Pro, Pro+ and Max. On Copilot Business and Enterprise, an administrator has to switch on the “MCP servers in Copilot” policy.

  1. Open the Command Palette: Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows.
  2. Choose “MCP: Add Server” → “HTTP”.
  3. Paste the connection URL into “Enter Server URL” and enter firstage in “Enter Server ID”. To use it in every project, save it to “Copilot Global”.
  4. Start the server and review VS Code’s trust prompt. When a Firstage page opens in your browser, sign in and allow access.
  5. In the chat box, open “Configure Tools” and switch on Firstage’s tools.
When the connection check brings back your list of journeys, you’re done.

You need a current Gemini CLI signed in with a Gemini Code Assist Standard or Enterprise license or a paid Gemini API key. Since June 18, 2026, free users and Google AI Pro and Ultra subscribers use Antigravity CLI instead, and Firstage hasn’t checked a connection through Antigravity CLI yet.

  1. Register Firstage in the terminal. It’s registered for the current folder.

    Terminal window
    gemini mcp add --transport http firstage https://api.firstage.ai/mcp
  2. Type gemini in the terminal to open a conversation.

  3. Enter /mcp auth firstage in the Gemini message box. When a Firstage page opens in your browser, sign in and allow access.

  4. Type /mcp list and check that firstage shows “Connected”.

When the connection check brings back your list of journeys, you’re done.
  • No browser opened. Open the sign-in URL your tool or terminal shows in a browser on the same computer. In Cursor, it’s under “Output” → “MCP:firstage”. Keep the tool running while you sign in.
  • The consent screen returns to localhost. A terminal tool returns to your own computer. Another program on that computer could receive the answer, so allow it only when you started the connection yourself.
  • Sign-in expired. In Codex or Claude Code, run the login command or “Authenticate” again.
Still have a question?You can ask the Firstage team in a chat.