Connect your AI tool

Codex desktop app

Add it from the settings screen. Codex inside the ChatGPT desktop app works the same way.

1. Open Settings, then select MCP servers.
2. Select Add server.
3. Enter gensapps as the name, choose Streamable HTTP, and enter the address below as the URL.
4. Save, then select Restart. Type /mcp in the composer to see connected servers.

Add with a command (Codex CLI)

The desktop app, CLI and IDE extension share one config file (~/.codex/config.toml). Add it once and it shows up everywhere.

$ codex mcp add gensapps --url https://deploy.gensapps.com/mcp
Added global MCP server 'gensapps'.
$ codex mcp list

Claude Code (CLI)

Add it with one command.

1. Run the command below in a terminal. Do not leave out --transport http.
2. Add --scope user to use it in every project. Without it, the server is visible only in the current project.
3. You are done when claude mcp list shows Connected. Inside Claude Code, check with /mcp.

$ claude mcp add --transport http --scope user gensapps https://deploy.gensapps.com/mcp
$ claude mcp list
gensapps: https://deploy.gensapps.com/mcp (HTTP) - ✔ Connected

The Code tab in the Claude desktop app uses the same configuration. Add it once from a terminal.

Claude Code extension for VS Code

Add it from /mcp in the chat panel or from the integrated terminal.

1. Type /mcp in the Claude Code extension's chat panel. A dialog opens where you add and toggle servers.
2. Add a server and enter the address below. Adding from this dialog needs Claude Code 2.1.261 or later.
3. Start a new conversation, then check for Connected in /mcp. Conversations opened before you added it are not affected.

Add from the integrated terminal

Open a terminal with Ctrl+` and run the same command as Claude Code. The extension and CLI share one configuration. If you installed only the extension, the claude command may be missing; use the /mcp dialog above.

$ claude mcp add --transport http gensapps https://deploy.gensapps.com/mcp

Claude desktop app · claude.ai (chat)

Add it as a custom connector.

1. Go to Customize > Connectors.
2. Select + Add, then Add custom connector.
3. Enter a name and the address below as the server URL, then select Continue.
4. Under Authentication choose No sign in, then finish with Add.
5. Turn Deploy on under + > Connectors in the chat box. While it is off, Claude does not use the deploy tool.

Chat apps cannot run commands, so they publish the page made in the conversation directly. List and delete your sites in My sites in the browser. The Free plan allows one custom connector. See Deploy straight from web chat for how to use it after connecting.

Cursor

Put the address in the config file.

1. Open ~/.cursor/mcp.json. Create it if it does not exist.
2. Put the entry below inside mcpServers. Leave any other servers as they are.
3. Save and restart Cursor. You are done when it appears under Customize > MCPs.

{
  "mcpServers": {
    "gensapps": { "url": "https://deploy.gensapps.com/mcp" }
  }
}

ChatGPT

Add it on the web as a custom MCP server.

1. Open chatgpt.com/plugins on the web.
2. Select +, then Add custom MCP server.
3. Enter a name and the address below as the Server URL.
4. Under Authentication choose No authentication, read the notice, then select I understand and want to continue.
5. Select Create as a plugin, then install the plugin you created. Without installing, it cannot be used in conversations.
6. In a new conversation, type @, choose the plugin you just created, then say “deploy this”. If you do not choose it, ChatGPT answers that it has no deploy tool.

Depending on your plan and workspace settings this menu may not be shown. ChatGPT cannot run commands either, so it publishes the page made in the conversation directly. See Deploy straight from web chat for how to use it after connecting.

Log in after adding it

Link your account by saying “log in to GenAI Labs”.

After adding it, you just talk. You can deploy without logging in. Logging in gathers your sites under your account and keeps them longer.

On your own computer (Codex · Claude desktop · VS Code)

1. Say “log in to GenAI Labs” or “log in to the deploy environment”.
2. Your browser opens. Choose your Google account.
3. When you see “Linked”, you are done. Go back to your editor and it continues.

In a remote environment (SSH · cloud · no screen)

1. Ask to log in the same way. If no browser can be opened, the AI gives you an address.
2. Open that address in any browser, including your phone, and log in with Google.
3. Your browser shows a verification code. Paste that code to the AI.
4. When it answers “Logged in”, you are done. The code works for 5 minutes only.

If your browser is already logged in to Deploy, you just press “Link” without going through Google again. With an ID and password account, log in first, then open the address.

How to use it after logging in is in the User guide, including when you need to log in again and how to disconnect an editor.

If you did not start this login, do not give the verification code to anyone. Chat apps (Claude · ChatGPT) cannot run commands, so log in in the browser.

Connect with an access token

Use this where a sign-in window can't open, or to use one account on several machines. Put a 12-character token in your MCP settings as a header and the tools work in your account right away.

1. Sign in to Deploy, go to Access tokens in your profile, pick a name and a duration (7, 30 or 90 days) and press Create token.
2. Copy the value (XXXX-XXXX-XXXX). It's shown only this once.
3. Put it in the Authorization header of your MCP settings as below, then restart the editor.

Claude Code

$ claude mcp add --transport http --scope user gensapps https://deploy.gensapps.com/mcp \
    --header "Authorization: Bearer XXXX-XXXX-XXXX"

Cursor · VS Code

{
  "mcpServers": {
    "gensapps": {
      "url": "https://deploy.gensapps.com/mcp",
      "headers": { "Authorization": "Bearer XXXX-XXXX-XXXX" }
    }
  }
}

Codex

[mcp_servers.gensapps]
url = "https://deploy.gensapps.com/mcp"
http_headers = { "Authorization" = "Bearer XXXX-XXXX-XXXX" }

The ChatGPT and Claude chat apps can't add headers. Use them without signing in there; account linking (OAuth) is on the way.

Treat the token like a password. Don't paste it into a chat, and revoke it in your profile when you stop using it. When it expires, create a new one and swap it in.

Try a deploy

The quickest way to check the connection.

1. Say “deploy this” or “upload it to GensApps”.
2. The AI uploads it and gives you an address. Just send that address.
3. See what you uploaded in My sites.