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.
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.
Before you start
Section titled “Before you start”- 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.ai
Section titled “Claude.ai”| Claude plan | What you can do | Evidence |
|---|---|---|
| Every plan | Use connectors you add yourself | Verified |
| Free | Add one connector of your own | Verified |
- Sign in to claude.ai in a browser on your computer.
- In “Customize” → “Connectors”, choose “Add custom connector”.
- Enter Firstage in “Name”, paste the connection URL above into the server URL field, then choose “Continue”.
- If Claude asks whether you trust this unverified connector, check that the address matches the connection URL above, then go on.
- When a Firstage page opens in your browser, sign in and allow access.
- Back in a Claude chat, open “+” → “Connectors” and switch on Firstage.
- 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.
ChatGPT
Section titled “ChatGPT”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 |
- Sign in to ChatGPT in a browser on your computer and open chatgpt.com/plugins.
- Choose “+” → “Add custom MCP server”.
- Enter Firstage as the name and paste the connection URL above into the URL field.
- Choose “OAuth” for authentication. Review the tools and install it.
- When a Firstage page opens in your browser, sign in and allow access.
- In a new chat, type
@in the message box and choose Firstage.
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.
Gemini app
Section titled “Gemini app”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 |
- Sign in to gemini.google.com in a browser on your computer.
- Open “Settings” → “Connected Apps” → “Custom apps” → “Add a custom app”.
- Paste the connection URL above into the MCP server URL field.
- When a Firstage page opens in your browser, sign in and allow access.
- A connection added on the web also works in the Gemini mobile app.
- Gemini asks you to confirm every change it makes in Firstage.
Sign in and allow access
Section titled “Sign in and allow access”When your AI app starts connecting, a Firstage page opens in your browser.
- Sign in to Firstage.
- On the consent screen, check the name of the app asking to connect and the address it returns to.
- Everything under “Always included” needs no switch. Making photobook, calendar and card drafts is in it.
- Under “Optional permissions”, switch on only what you want to allow. Every switch starts off. Permissions explains each one.
- Tap “Allow”. When you see “Access allowed”, go back to your AI app.
Check the connection
Section titled “Check the connection”This request checks the connection without making anything yet. Paste it into your AI app’s message box and send it.
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.
If it doesn’t work
Section titled “If it doesn’t work”- 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.
Disconnect
Section titled “Disconnect”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.
Connect from developer tools
Section titled “Connect from developer tools”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
Section titled “Claude Code”Claude Code needs a Claude Pro, Max, Team or Enterprise plan or a Console account. Claude Free doesn’t include it.
-
In the terminal, add the Firstage marketplace.
Terminal window claude plugin marketplace add firstage-ai/skills -
In the same terminal, install the Firstage plugin. It installs the Firstage connection together with the skills.
Terminal window claude plugin install firstage@firstage -
Type
claudein the terminal to open Claude Code. -
Type
/mcpin the message box, choose firstage, then choose “Authenticate”. -
When a Firstage page opens in your browser, sign in and allow access.
/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.
claude mcp add --transport http firstage https://api.firstage.ai/mcpCodex is included in every ChatGPT plan, and its usage is shared with ChatGPT.
-
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 -
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 -
Type
codexin the terminal to open it, then type/mcpin the message box and check that firstage and its tools appear.
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.
Cursor
Section titled “Cursor”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.
-
Open
.cursor/mcp.jsonto use it in this project only, or~/.cursor/mcp.jsonfor every project. -
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"}}} -
Save the file and switch on Firstage in Cursor’s “Customize” screen.
-
When a Firstage page opens in your browser, sign in and allow access.
VS Code with GitHub Copilot
Section titled “VS Code with GitHub Copilot”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.
- Open the Command Palette: Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows.
- Choose “MCP: Add Server” → “HTTP”.
- 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”.
- Start the server and review VS Code’s trust prompt. When a Firstage page opens in your browser, sign in and allow access.
- In the chat box, open “Configure Tools” and switch on Firstage’s tools.
Gemini CLI
Section titled “Gemini CLI”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.
-
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 -
Type
geminiin the terminal to open a conversation. -
Enter
/mcp auth firstagein the Gemini message box. When a Firstage page opens in your browser, sign in and allow access. -
Type
/mcp listand check that firstage shows “Connected”.
If a terminal tool gets stuck
Section titled “If a terminal tool gets stuck”- 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.
Read next
Section titled “Read next”The chat could not open. Please email us at contact@firstage.ai