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
- An AWSYS.CO account (any plan)
- Claude.ai, ChatGPT or Codex with support for MCP connectors
Connect Claude.ai
-
Open Customize in Claude.ai
In Claude.ai, open Customize in the sidebar. -
Go to Connectors → Add → Add custom connector
Under Connectors, click Add, then Add custom connector. -
Enter the AWSYS MCP server URL
Pastehttps://awsys.co/mcpinto 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. -
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. -
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
-
Search for AWSYS Links
In ChatGPT, go to Plugins and search for “AWSYS Links”. -
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
-
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. -
Enter the server details
Usehttps://awsys.co/mcpas the server URL and choose OAuth as the authentication method. -
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:
- Links: shorten one or many URLs; list, view, update and delete links; check link safety
- Statistics: per-link statistics, recent clicks and, on Builder and higher, per-link analytics breakdowns
- QR codes: get a link's QR code and view or change its QR settings
- Folders and tags: create, rename and delete folders, move links between folders, add and remove tags
- UTM templates and saved views: list, create and delete them, and update saved views
- Account: your plan and usage
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
- Start Claude Code, type /mcp, select awsys and choose Authenticate.
- 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" }
}
}
- In Cursor's MCP settings, click the sign-in prompt next to awsys.
- 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" }
}
}
- When VS Code starts the server, sign in to AWSYS in your browser and click Allow Access.
- Open Copilot Chat in agent mode — the AWSYS tools appear in the tools picker.
Grok
- On grok.com, open Connectors and click New Connector.
- Choose Custom, name it AWSYS and paste https://awsys.co/mcp as the URL.
- 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
- Start Gemini CLI and run /mcp auth awsys.
- Sign in to AWSYS in your browser and click Allow Access.
Perplexity
- In Perplexity, open Settings → Connectors.
- Add a custom connector, choose Remote and paste https://awsys.co/mcp as the URL.
- Sign in to AWSYS when prompted and click Allow Access.
Available where your Perplexity plan supports custom connectors.
Le Chat (Mistral)
- In Le Chat, open Connectors and add a custom MCP connector.
- Paste https://awsys.co/mcp as the server URL and choose OAuth authentication.
- 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.