How to connect Ably to Claude

Connect Claude Web, Desktop and Cowork to Ably MCP. List all active channels and their details, get message history from 'support-chat' channel, and more using natural language, with authentication handled for you.

Ably logoAbly
Api Key

Ably is a real-time messaging platform for live chat and data sync in modern apps. It offers global scale and rock-solid reliability for seamless, instant experiences.

25 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Ably account to Claude via Composio Connect, enabling it to list all active channels and their details, get message history from 'support-chat' channel, show presence history for 'live-event' channel, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Ably with

Connecting Ably to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Ably account

Back in Claude, ask it to connect to Ably or give it any Ably-related task.

For example, ask Claude to:

  • "List all active channels and their details"
  • "Get message history from 'support-chat' channel"
  • "Show presence history for 'live-event' channel"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Ably account is ready to use.

What is the Ably Claude Connector, and what's possible with it?

The Ably MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Ably account. It provides structured and secure access to your channels, messages, presence data, application statistics, and push notifications, so your agent can publish messages, inspect active channels, review channel history, monitor presence, and manage push notifications on your behalf.

  • Channel messaging: Have your agent publish a message to one channel or send batches of messages across multiple channels.
  • Channel activity and history: Let the agent list active channels, retrieve channel details, review message history, and inspect earlier versions of a message.
  • Presence monitoring: Direct your agent to check who is currently present in one or more channels and review past presence activity.
  • Push notification management: Instruct your agent to send individual or batch push notifications, manage channel subscriptions, and register, update, inspect, or unregister receiving devices.
  • Application insights: Have your agent retrieve Ably service time and review application usage statistics.

Troubleshooting

1. Why does Claude not use the Composio connector for Ably?

The connector can show as connected, but Claude must use it in each Ably conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Ably again.

2. Why does Claude show an MCP server error before Ably connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Ably.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Ably.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Ably authorization link not work?

The Composio connector is one server. Your Ably account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Ably connection.
  • Composio creates a fresh Ably authorization link.
  • Open that link in your browser and finish the Ably sign-in.

4. Why do Ably actions fail after they worked before?

The Ably connection can expire or lose permission.

  • Ask Claude to inspect the Ably connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Ably account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Ably.
  • If the action still fails with a permission error, check that the connected account has that permission in Ably itself.

5. How do I switch to a different Ably account?

Claude can manage the Ably connection for you.

  • Ask Claude to disconnect or delete the current Ably account.
  • Ask Claude to connect Ably again.
  • Open the new Composio authorization link for Ably.
  • Sign in with the other Ably account in the browser.
  • After the account connects, ask Claude to retry the Ably task.

6. Why is my Ably connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Ably connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Ably tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Ably.
TOOLS

Supported Tools

Every Ably action and event your agent gets out of the box.

Query Batch Presence

Queries the presence states of multiple Ably channels in a single request, retrieving member presence details for the specified channels.

Query Batch Presence History

Query presence history for multiple Ably channels, with optional start and end times and forwards or backwards ordering.

Delete Channel Subscription

Unsubscribes a device or client from push notifications for a specified channel, or across all channels if no channel is provided.

Get Channel Details

Retrieves status and occupancy metadata for a specific Ably channel, including connection, presence, publisher, and subscriber metrics.

Get Channel History

Retrieves a page of message history for a specified Ably channel, with time range, limit, and direction filters.

Get Channel Presence

Tool to obtain the set of members currently present for a channel.

Get Message Versions

Retrieves a page of historical versions of a specific Ably channel message, including the original and subsequent updates or deletes.

Get Channel Presence History

This tool retrieves the history of presence messages for a specified channel in Ably.

Get Push Device Registration

Retrieves a device's push registration by device ID, including available platform, state, recipient, and metadata fields.

Get Ably Service Time

This tool retrieves the current server time from Ably's service in milliseconds since the epoch.

Get Application Stats

Retrieve a page of Ably application usage statistics by minute, hour, day or month, with optional time range, direction and limit.

List Channels

Tool to enumerate all active channels in the Ably application.

List Push Channels

Lists a page of Ably channels with at least one subscribed device for push notifications.

List Push Channel Subscriptions

Lists a page of push channel subscriptions filtered by channel, client ID, or device ID, with pagination links; at least one filter is required.

List Registered Push Devices

List a page of Ably push device registrations, optionally filtered by device ID or client ID.

Patch Push Device Registration

Partially update an existing Ably push device registration.

Batch Publish Messages

Tool to batch publish messages to multiple channels in parallel.

Publish Message to Channel

Publishes a message to a specified Ably channel with a string or JSON object payload and an optional event name and client ID.

Publish Push Notification

Tool to publish a push notification directly to device(s) via Ably's Push Notifications API.

Batch Publish Push Notifications

Tool to batch publish push notifications directly to specific recipients.

Register Push Device

Register an iOS, Android, or browser device with Ably to receive push notifications.

Request Access Token

Request an Ably access token with optional capabilities, client ID and lifetime.

Unregister All Push Devices

Unregister matching Ably push devices, optionally filtering by device ID or client ID, but not both.

Unregister Push Device

Unregister a single Ably push device by device ID.

Update Push Device Registration

Upsert an Ably push device registration, creating it or replacing an existing registration.

FAQ

Frequently asked questions

Start with Ably.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Ably tool your agent needs.Free to start.

Start building