Guide
Connect an AI tool to your account
Connect an AI coding tool to your InstaWormhole account so it can list and manage your tunnels.
- Applies to
- All plans; AI tools that support remote MCP servers with sign-in
- Time
- About 5 minutes
- What it changes
- Lets an AI tool read, and with your approval change, your tunnels until you disconnect it.
- Last reviewed
- , by Product documentation
Before you begin
- An InstaWormhole account you can sign in to.
- An AI tool that can add a remote MCP server and sign in to it.
What to know before you start
- The tool acts as you, within the permissions you approve. It can list your tunnels and, only if you allow it, create, stop or re-address them.
- Stopping a tunnel or giving it a new address needs a second agreement: the tool must ask you first, and the server refuses until it is told you agreed.
- The tool never receives request bodies or header values, and it cannot start a connector on your computer.
Steps
Step 1. Add InstaWormhole as a remote MCP server in your AI tool's settings.
Server address https://instawormhole.com/api/mcpWhere the setting lives depends on the tool. Look for the place to add a remote or custom MCP server, and paste the address. Use the transport called Streamable HTTP if the tool asks.
You should see: The tool starts a sign-in and opens your browser.
Step 2. Check who is asking, then approve.
The InstaWormhole page names the tool, shows the address you will be sent back to, and lists what it asks for: seeing your tunnels, creating or changing them, and seeing which requests reached them. Choose Approve only if you started the connection yourself.
You may be asked to sign in again first. That is expected: approving gives a tool lasting access.
You should see: Your browser returns to the tool, which says it is connected.
Step 3. Ask the tool to list your tunnels.
You should see: It answers with each tunnel's name, public address, state, access mode and whether a connector is online.
To check: Open Developer tools in the dashboard. The tool is listed under Connected AI tools with the time you approved it.
Step 4. To create a tunnel, tell the tool how it should be protected, then run the connector it names.
The tool asks you to choose between a password and a public address, and how long it should last. It cannot choose public for you. The new tunnel is not reachable until the connector runs on your computer; the tool shows the command.
You should see: The tool shows the new tunnel's address and the command to run.
To check: After you run the command, ask the tool for the connector status. It shows the tunnel online.
You are done when
- The tool lists your tunnels, and the tool appears under Connected AI tools in Developer tools.
If something goes wrong
- The approval page says the connection request is not valid.
- The page refuses a request it does not recognize, such as an incomplete link, a tool that is no longer registered, or a return address that does not match. Go back to the tool and start the connection again.
- The tool can list tunnels but cannot create or stop one.
- The tool was approved without that permission. Revoke it under Connected AI tools and connect again, approving the creating and changing permission.
- The tool says a stop or a new address was not done because confirmation is missing.
- Stopping or re-addressing is refused until the tool states that you agreed. Tell the tool to go ahead, and it asks again with that agreement.
- The tool reports too many requests.
- The connection is limited to 60 calls a minute. Wait a minute and try again.
Undo or clean up
- Open Developer tools, find the tool under Connected AI tools, and choose Revoke. It stops working at once.
Good to know
Related
This page is part of Automate and integrate. Still stuck? Contact support.