Connect AI assistants to your AWSYS account

Use the AWSYS MCP connector to work with your short links, analytics and QR codes directly inside Claude, ChatGPT or Codex — no API key needed.

Using a different assistant? See the one-click and step-by-step setup for every supported client on the AI assistants page.

Requirements

Connect Claude.ai

  1. Open Customize in Claude.ai
    In Claude.ai, open Customize in the sidebar.
  2. Go to Connectors → Add → Add custom connector
    Under Connectors, click Add, then Add custom connector.
  3. Enter the AWSYS MCP server URL
    Paste https://awsys.co/mcp into the server URL field, name the connector AWSYS and click Continue, then Connect. Claude.ai discovers the sign-in endpoints automatically — there is nothing else to configure.
  4. Sign in to AWSYS and approve the connection
    You are redirected to AWSYS.CO. Sign in if needed, review what Claude.ai is requesting on the consent screen, and click Allow Access.
  5. You're connected
    Claude.ai confirms the connection. You can now ask Claude to shorten URLs, check analytics, manage folders and more.

Connect ChatGPT and Codex

ChatGPT and Codex connect to the same AWSYS server with the same secure sign-in. In ChatGPT you can add AWSYS in two ways.

From the ChatGPT plugin directory

  1. Search for AWSYS Links
    In ChatGPT, go to Plugins and search for “AWSYS Links”.
  2. Connect and sign in
    Select AWSYS Links and connect it. Sign in to AWSYS when prompted and click Allow Access on the consent screen.

AWSYS Links appears in the directory once OpenAI has approved it. Until then, add it as a custom MCP server.

As a custom MCP server

  1. Add a custom MCP server
    In ChatGPT, go to Plugins, click the plus button and choose Add custom MCP server. Availability depends on your ChatGPT plan and workspace.
  2. Enter the server details
    Use https://awsys.co/mcp as the server URL and choose OAuth as the authentication method.
  3. Sign in and approve
    Sign in to AWSYS when prompted and click Allow Access on the consent screen.

Codex

Codex uses the same server URL, https://awsys.co/mcp, and the same OAuth sign-in. Run codex mcp add awsys --url https://awsys.co/mcp, then codex mcp login awsys, and approve the consent screen in your browser.

What ChatGPT can do

In ChatGPT, AWSYS offers a curated set of 29 tools for everyday link work:

Some tools need a paid plan: bulk shortening and detailed per-link analytics need the Builder plan, and custom slugs need the Starter plan or higher.

Webhooks, custom domains, namespaces, imports, AgentLink and affiliate programs are not available in ChatGPT.

Claude, Cursor and other MCP clients

Claude, Cursor and other MCP clients keep the full AWSYS tool set — up to 65 tools, depending on your plan — including webhooks, custom domains, namespaces, imports, AgentLink and affiliate programs. Your plan limits apply exactly as they do in the dashboard.

Connected assistants cannot change your plan, billing details or password.

More AI assistants

These assistants connect to the same server URL, https://awsys.co/mcp, and sign you in with OAuth — no API key needed. Menu names can differ slightly between versions and plans.

Claude Code

Run in your terminal:

claude mcp add --transport http awsys https://awsys.co/mcp
  1. Start Claude Code, type /mcp, select awsys and choose Authenticate.
  2. Sign in to AWSYS in the browser window that opens and click Allow Access.

Cursor

Fastest: use the Add to Cursor button on the AI assistants page. Or set it up manually:

Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project), then sign in from Cursor's MCP settings:

{
  "mcpServers": {
    "awsys": { "url": "https://awsys.co/mcp" }
  }
}
  1. In Cursor's MCP settings, click the sign-in prompt next to awsys.
  2. Sign in to AWSYS in your browser and click Allow Access.

VS Code / GitHub Copilot

Fastest: use the Add to VS Code button on the AI assistants page. Or set it up manually:

Add this to .vscode/mcp.json in your workspace, then start the server and sign in when VS Code asks:

{
  "servers": {
    "awsys": { "type": "http", "url": "https://awsys.co/mcp" }
  }
}
  1. When VS Code starts the server, sign in to AWSYS in your browser and click Allow Access.
  2. Open Copilot Chat in agent mode — the AWSYS tools appear in the tools picker.

Grok

  1. On grok.com, open Connectors and click New Connector.
  2. Choose Custom, name it AWSYS and paste https://awsys.co/mcp as the URL.
  3. Sign in to AWSYS when prompted and click Allow Access.

Available where your Grok plan supports custom connectors. On business plans, an admin may need to enable them first.

Gemini CLI

Run in your terminal:

gemini mcp add --transport http awsys https://awsys.co/mcp
  1. Start Gemini CLI and run /mcp auth awsys.
  2. Sign in to AWSYS in your browser and click Allow Access.

Perplexity

  1. In Perplexity, open Settings → Connectors.
  2. Add a custom connector, choose Remote and paste https://awsys.co/mcp as the URL.
  3. Sign in to AWSYS when prompted and click Allow Access.

Available where your Perplexity plan supports custom connectors.

Le Chat (Mistral)

  1. In Le Chat, open Connectors and add a custom MCP connector.
  2. Paste https://awsys.co/mcp as the server URL and choose OAuth authentication.
  3. Sign in to AWSYS when prompted and click Allow Access.

Available where your Le Chat plan supports custom connectors. In organizations, an admin adds custom connectors.

Managing the connection

A connection stays active until you disconnect it, or until it goes unused for 30 days. Your assistant renews access in the background, so you won't be asked to approve it again while you keep using it.

To disconnect, open Settings → Developer → Connected apps in AWSYS and click Disconnect next to the assistant. It takes effect immediately.

You can also remove the connector from the assistant itself: in Claude.ai under Customize → Connectors, or in ChatGPT from the AWSYS plugin's settings.

Frequently asked questions

Does this work on mobile?

Set up the connector from the web version of Claude.ai or ChatGPT. To connect tools such as Claude Code with an API key instead, see the MCP developer docs.

Is my AWSYS password shared with the assistant?

No. The OAuth sign-in never shares your password. The assistant receives a short-lived access token that can only call AWSYS MCP tools — it has no access to your password or billing information.

What if I see “Couldn't register with AWSYS.co's sign-in service”?

Refresh the assistant's connector settings page and connect again. If the problem continues, contact support.

Can I connect multiple AWSYS accounts?

Each assistant connects to one AWSYS account at a time. To switch accounts, disconnect the existing connection, then connect again while signed in to the other account.