All guides

Connect an AI assistant

MicroURL has a Model Context Protocol (MCP) server, so an AI assistant like Claude or ChatGPT can list, view, create, edit, and delete your short links directly in a conversation. These are the same actions you'd otherwise do by clicking through the dashboard.

1

Add MicroURL as a connector

You add MicroURL once, using this address:

https://mcp.getmicrourl.com/mcp

In Claude (claude.ai or the Claude app, on any plan; the free plan allows one custom connector): go to Customize → Connectors, click + Add, choose Add custom connector, name it MicroURL, paste the address and click Add. In a chat, turn it on from the + button under Connectors.

In ChatGPT, custom connectors are only available in Business, Enterprise and Edu workspaces, and a workspace admin adds them: Plugins → + → Add custom MCP server, paste the address and choose OAuth for sign-in.

In other assistants, look for “custom connector” or “MCP server” in settings. These menus change often; the steps above are from each app’s help center, checked 23 October 2026.

2

Sign in and approve

You’ll be sent to MicroURL to sign in (if you aren’t already) and see a screen asking you to approve the connection for your organization. Approving creates a new API key labeled with the assistant’s name, for example “AI assistant: Claude (claude.ai)”. You can see it any time under Settings → API Keys, and revoke it there like any other key. Approving the same assistant again replaces its key.

3

Just ask

Once connected, ask in plain language, like “list my MicroURL links,” “create a short link to example.com/pricing,” or “deactivate my link with slug old-promo.” You can also ask how a link is doing: “how many people scanned my menu QR code this week, and from where?” The assistant calls the right tool for you.

4

What it can and can't do

It can list links, get one link’s details, get a link’s clicks (last 7, 30 or 90 days, with countries, websites, devices and languages), create a link, update a link, and delete a link. It can also list, create and edit link-in-bio pages (“make a bio page for Rosa’s Kitchen with buttons for the menu and booking”).

Deleting is deliberately a two-step process. The assistant previews what it’s about to delete and needs a second, explicit confirmation before anything is actually removed. If your assistant’s own interface shows a “needs approval” prompt for tool calls, you’ll typically see that too.

Account-level changes (API keys, custom domains, team members, billing) stay dashboard-only; the assistant can’t touch those.

5

Revoke access any time

Go to Settings → API Keys and revoke the key labeled with the assistant’s name. It loses access immediately.