vaaya / get started

Connect Vaaya to your AI in a few clicks

New to MCPs and connectors?

A “connector” just links your AI app to Vaaya — no code, no API key. Two things make the rest obvious, then pick your app above.

Apps you set up by clicking

Claude Desktop, Claude on the web, ChatGPT, Cursor, and VS Code. You add Vaaya from a settings screen inside the app — no typing of commands.

Tools you set up in the terminal

Claude Code, Codex, Gemini CLI. You paste one line into their text window and press Enter. Here’s how to open that window.

How to open the typing window

Only needed for the terminal tools. It’s a built-in app on every computer — here’s how to find it and paste into it.

On a Mac — “Terminal”

Press ⌘ Cmd + Space, type Terminal, press Enter. A window opens — click in it, paste with ⌘ Cmd + V, press Enter to run.

On Windows — “Command Prompt”

Press the ⊞ Windows key, type cmd, press Enter. In the window, paste with Ctrl + V (or right-click), press Enter to run.

You do not need “npx”, “mcp-remote”, or any helper. Vaaya is hosted, so every app connects straight to https://vaaya.ai/mcp.

Set up inside the app Clicking

Add Vaaya from a settings screen — paste the address, sign in, done. No terminal.

Claude Desktop

The Claude app for Mac / Windows

In the app
  1. Open Claude and make sure you’re signed in. (Custom connectors need a paid plan — Pro, Max, Team, or Enterprise.)
  2. Open Customize, then Connectors. (Custom connectors moved here — they’re no longer under Settings.)
  3. Click Add custom connector.
  4. Name it Vaaya, paste the address below into the URL box, and click Add.
  5. Your browser opens — sign in with Google and approve. Vaaya’s tools now appear in the chat’s tools menu.

Paste this as the URL

https://vaaya.ai/mcp

Claude on the web

claude.ai in your browser

In the app
  1. Open claude.ai and make sure you’re signed in. (Custom connectors need a paid plan.)
  2. Open Customize — it’s in the sidebar / your profile menu — then Connectors. (It lives under Customize, not Settings.)
  3. Click Add custom connector.
  4. Name it Vaaya, paste the address below, and click Add.
  5. In the popup, sign in with Google and approve.

Paste this as the URL

https://vaaya.ai/mcp

Cursor

The Cursor code editor

In the app
  1. Open Cursor → Settings → Cursor Settings → Tools & Integrations (the MCP section).
  2. Click New MCP Server (or Add custom MCP) — Cursor opens its mcp.json file.
  3. Paste the Vaaya block below, save the file, and go back to Settings.
  4. Switch Vaaya on. When your browser opens, sign in with Google and approve.
{
  "mcpServers": {
    "vaaya": { "url": "https://vaaya.ai/mcp" }
  }
}

VS Code

GitHub Copilot · Agent mode

In the app
  1. Make sure GitHub Copilot is enabled and you’re in Agent mode (MCP runs through Copilot).
  2. Open the Command Palette — ⌘ / Ctrl + Shift + P — and run MCP: Add Server.
  3. Choose HTTP, paste the address below, and name it Vaaya.
  4. When prompted, sign in with Google to authorize. (Prefer files? Paste the block below into your mcp.json instead.)

Paste this as the URL

https://vaaya.ai/mcp
{
  "servers": {
    "vaaya": { "type": "http", "url": "https://vaaya.ai/mcp" }
  }
}

ChatGPT on the web

chatgpt.com in your browser · needs Developer Mode

In the app
  1. Open chatgpt.com and make sure you’re signed in on a paid plan (Plus, Pro, Team, or Enterprise).
  2. Turn on Developer Mode: Settings → Connectors → Advanced, then switch on Developer mode.
  3. Go to Settings → Connectors and click Create (custom connector).
  4. Name it Vaaya, paste the address below, set authentication to OAuth, and click Create. Sign in with Google when the browser opens.
  5. In a chat, open the + / tools menu and switch Vaaya on.

Paste this as the MCP server URL

https://vaaya.ai/mcp

ChatGPT is cautious with paid tools — it may describe a plan instead of running it. Just tell it: “call the use tool now to execute” and it will run.

Set up in the terminal One line

You already have these tools — just paste one line to add Vaaya.

Claude Code

Add Vaaya with one command

In the terminal
  1. Open your terminal — the same place you normally run claude. (New to it? See How to open the typing window above.)
  2. Paste the line below and press Enter. That’s the whole setup.
  3. Start Claude Code (claude), type /mcp, choose vaaya, and pick Authenticate — your browser opens, sign in with Google and approve.

Add Vaaya (same on Mac and Windows)

claude mcp add --transport http --scope user vaaya https://vaaya.ai/mcp

Gemini CLI

Add Vaaya with one command

In the terminal
  1. Open your terminal — the same place you run gemini.
  2. Paste the line below and press Enter.
  3. Start Gemini (gemini) and type /mcp to finish signing in to Vaaya in your browser.

Add Vaaya

gemini mcp add --transport http vaaya https://vaaya.ai/mcp

Codex CLI

Add Vaaya in your config file

In the terminal
  1. Open (or create) the file .codex/config.toml in your home folder. Mac: ~/.codex/config.toml · Windows: C:\Users\<you>\.codex\config.toml.
  2. Add the lines below and save.
  3. Start codex. The first time it uses Vaaya it opens your browser to sign in with Google.
experimental_use_rmcp_client = true

[mcp_servers.vaaya]
url = "https://vaaya.ai/mcp"

Newer Codex versions can add it from the terminal — run codex mcp --help to check.

Check it’s working

One quick test confirms Vaaya is connected before you rely on it.

Any app — ask it to use Vaaya

Send this message to your AI:

Use the Vaaya consult tool and tell me what you can do.

You’re good to go when it actually runs the tool and replies with what Vaaya can reach (images, web, voice, compute…) — no “not connected” or sign-in error. If it only talks about Vaaya, add: “call the tool now.” (This uses the free consult tool — nothing is charged.)

Claude Code / Gemini CLI — run /mcp

In the terminal, type /mcp and look for Vaaya listed as connected:

vaaya   ✔ connected · 21 tools

If it shows connected with tools, you’re set. Not there? Re-run the add command above, then /mcp again.

If something doesn’t work

The four things people ask most.

It’s stuck on “Sign in”, or a tool says “insufficient scope”

Remove the connector and add it again. A plain “Reconnect” reuses old, limited permissions — a fresh add fixes it.

Which address do I use?

Copy https://vaaya.ai/mcp exactly — it’s the only address you ever paste into any app.

Do I need “npx” or “mcp-remote”?

No. Vaaya is hosted, so every app connects straight to the address. You never install a bridge.

What does it cost to try?

You start with $100 in free credit, and you’re only charged for calls that actually run — failed calls aren’t billed.