Model Context Protocol

Your MCP server URL

Each Aqtos instance has its own endpoint. Replace {instancename} with the subdomain you use to sign in to Aqtos.

Automatic copying is unavailable. Select the server URL above and copy it.

Use the full address, including /api/mcp/ and the trailing slash. This is a server endpoint to add in your AI client.

Set up your AI tool

Follow your tool’s official guide, use your Aqtos MCP server URL, and complete OAuth sign-in. Custom MCP setup is separate from the directory plugin and connector statuses above.

• 

  Claude

  Web & desktop

  Add a custom connector in Customize → Connectors. Enter your instance URL and follow the sign-in flow. Team workspaces may need an owner to add it first.

  Setup guide ↗
• 

  ChatGPT

  Web

  Open Plugins, use the plus menu to add a custom MCP server, and enter your instance URL. Select OAuth, then create and install your custom plugin.

  Setup guide ↗
• 

  Grok

  Web

  Open Connectors, choose New Connector → Custom, and enter your instance URL. Complete authentication when prompted.

  Setup guide ↗
• 

  GitHub Copilot

  VS Code

  Run “MCP: Add Server” in the Command Palette and follow the remote-server setup. Use your Aqtos URL and complete the connection prompts.

  Setup guide ↗
• 

  Microsoft Copilot Studio

  Custom agents

  Use the MCP onboarding wizard to connect your agent to an existing server. Follow Microsoft’s configuration and authentication steps for your environment.

  Setup guide ↗
• 

  Cursor

  Editor

  Add Aqtos as a remote server in your MCP configuration. Set its URL to your instance endpoint and follow Cursor’s OAuth setup instructions.

  Setup guide ↗
• 

  Claude Code

  Coding agent

  Follow the remote HTTP server setup, add your Aqtos endpoint, and authenticate the server through Claude Code’s MCP controls.

  Setup guide ↗
• 

  Codex

  CLI & IDE

  Configure a remote MCP server named aqtos with your instance URL, then run “codex mcp login aqtos” to complete OAuth sign-in.

  Setup guide ↗
• 

  Gemini CLI

  Command line

  Add your Aqtos endpoint as a remote HTTP MCP server in Gemini CLI’s configuration. Follow the guide’s OAuth authentication flow.

  Setup guide ↗

Menu names and access can vary by plan, version and workspace policy. “GitHub Copilot” here means Copilot in VS Code; “Copilot Studio” is Microsoft’s agent builder. If a client asks for OAuth settings it cannot discover, contact the Aqtos team.

Connect to Aqtos

You’ll need an Aqtos account with access to your instance and an AI client that supports remote MCP connections with OAuth.

1. Add a remote MCP server

   Open your AI client’s integrations or MCP settings and add a server. Give it a recognizable name, such as Aqtos.

2. Paste your instance URL

   Use the full endpoint from Your MCP server URL. Choose a remote HTTP connection if your client asks for a connection type.

3. Authenticate with OAuth

   Select OAuth if prompted, then start the connection. Follow the sign-in flow, use the Aqtos account for that instance, and review the permissions before authorizing access.

4. Return to your assistant

   Finish the connection in your AI client and check that it can discover the available Aqtos tools. Try the prompt below.

Try asking

“What Aqtos tools are available in this workspace?”

Authentication & access

Aqtos MCP uses OAuth. Complete the sign-in and authorization flow in your browser; you do not need to paste your Aqtos password or an API key into a chat.

• Connect each instance separately. Use its own URL and an account with access to that instance.
• Let your client handle the OAuth flow. If it requires a client ID, secret or scopes that it cannot discover, ask the Aqtos team for the settings for your instance.
• Reconnect when needed. If authorization expires or is revoked, run the sign-in flow again from your client.
• Disconnect when you’re done. Remove the connection in your AI client. To revoke any remaining authorization, ask your instance administrator or the Aqtos team.

Working with available tools

Your assistant discovers the tools exposed by your Aqtos instance after connecting. Available actions depend on that instance and the access granted to your connection.

Start by asking what the connection can do. Then ask the assistant to use a listed tool for your task. Before making changes, ask it to show the proposed action and wait for your confirmation.

Troubleshooting