Skip to main content

Getting Started with AiSky MCP

Connect AiSky to your AI app in under 2 minutes. Once connected, you can manage voice agents, campaigns, contacts, and deals through natural conversation. Every app connects the same way: add this address, then sign in to AiSky in your browser and press Allow.
There is no API key to create and no password saved in a file. Pick your app to jump straight to its setup:

ChatGPT

Add a custom connector.

Claude

Add a custom connector.

Claude Code

A single command.

Cursor

Add to .cursor/mcp.json.

Codex

Two commands.

Gemini CLI

Add to settings.json.

Prerequisites

  • A AiSky account at aisky.co.za
  • An AI app that can connect to a remote MCP server by URL and sign in

What the app can do

Once you sign in, the AI app acts as you, in the workspace you last opened in AiSky, with your role’s permissions. Tools your plan, add-ons or role don’t allow are hidden. Actions that spend money, contact real people or delete something for good show you a preview and wait for your yes. Security and permissions covers this in full.

Use fewer tokens: the lean address

If you pay for your AI app by the token, connect to this address instead:
The standard address hands your AI app every AiSky tool at the start of each chat, which is about 40,000 tokens before you type anything. The lean address hands over seven tools, about 1,600 tokens, and the AI looks up the rest when it needs them:
  1. It searches for the tool that fits your request.
  2. It reads that one tool’s details.
  3. It runs the tool through the run tool for its kind: one for looking things up, one for adding something, and one for anything that spends, contacts people, deletes, overwrites or changes your team.
Your permissions, previews and yes-before-it-acts steps are exactly the same. Each request takes a step or two more, a second or two in chat. Sign in the same way as below. Apps that ask before running a tool ask per run tool, so allowing lookups never allows a change.

Client Configuration

ChatGPT

Go to Settings, then Connectors (custom connectors). On plans that require it, turn on developer mode first. Choose Add or Create a custom connector, paste the address below, and sign in to AiSky when prompted.

Claude (web and desktop)

  1. Go to Customize → Connectors.
  2. Click + Add, then Add custom connector.
  3. Name it AiSky, paste https://mcp.getsmartalex.com, and follow the steps to add it.
  4. Press Connect and sign in to AiSky when prompted.
On Team and Enterprise plans, an owner adds the connector under Organization settings → Connectors. Members then find it under Customize → Connectors and press Connect.

Claude Code

Sign in when Claude Code asks. If it does not ask, run /mcp, choose smartalex, then Authenticate.

Cursor

Add to .cursor/mcp.json in your project root, or ~/.cursor/mcp.json to use it in every project:
Then open Settings → Tools & MCP, find smartalex, press Connect, and sign in.

Codex

The second command opens your browser so you can sign in.

Gemini CLI

Add to your Gemini CLI settings file: Location: ~/.gemini/settings.json
Then start Gemini CLI and run /mcp auth smartalex to sign in. Sign-in opens a browser on the same machine, so it does not work in a session with no browser, such as a remote SSH session.

VS Code and other apps

AiSky works with any MCP app that can connect to a remote server by URL and sign in. Use https://mcp.getsmartalex.com.

Signing In

When you connect, your AI app opens AiSky in your browser. Sign in and press Allow. The app never sees your password.
  • The app works in the workspace you last opened in AiSky. To work in a different workspace, switch to it in AiSky first.
  • You don’t need an API key to connect. Owners and admins can create a read-only key in Settings → Webhooks & API for other uses.
  • To disconnect an app, open the user menu at the top right of AiSky and go to Account → Security → Where you’re signed in. Find the app and press Sign out. Signing out of the AiSky website does not disconnect your AI apps.

Your First Tool Call

Once connected, try asking your AI assistant:
“Show me my AiSky contacts”
The assistant will use the smartalex_list_contacts tool and return your contacts:

More Examples

Check platform health:
“What’s the status of my AiSky platform?”
Analyze recent calls:
“Show me my recent calls”
Create a contact:
“Add a new contact: John Smith, john@acme.com, +1 555 987 6543”
Review your pipeline:
“Show me all deals in the offer stage”
Create a campaign:
“Create an outbound campaign called Q2 Outreach”

Cloud vs Local

Recommendation: Use the cloud server. The npm package is older, has fewer tools, and needs an API key.

Troubleshooting

”Sign-in expired” or “Invalid or expired token”

  • Sign in again from your AI app. In Claude Code, run /mcp, choose smartalex, then Authenticate. In Codex, run codex mcp login smartalex. In Gemini CLI, run /mcp auth smartalex.
  • Brand-new account? If this happens straight after you sign in, your workspace may not be set up yet. Open AiSky in your browser, finish setting up your workspace, then sign in again.

Tools missing after connecting

  • Restart or reload your AI app after configuration changes
  • For Cursor: use the command palette > “Reload Window”
  • For Claude Code: run /mcp to check server status
  • Some tools are hidden by your plan, add-ons or role. Campaign tools need the Outbound Campaigns add-on. HTTP tools and creating or deleting webhooks need Power Tools. Creating an agent needs a free agent slot. A tool your role cannot use stays unavailable until a workspace owner or admin changes your role.
  • The app works in the workspace you last opened in AiSky. If you expected a different workspace, switch to it in AiSky.

”reconnection failed” (Cloud)

The cloud MCP server runs in stateless mode. If you see a reconnection error, simply reconnect, each request is independent and doesn’t require a persistent session.

Rate Limiting

If you see HTTP 429 responses, you’ve exceeded the rate limit (100 requests per minute per workspace). Wait for the Retry-After header duration and retry. Most AI clients handle this automatically.

Next Steps