Connect Claude Code

SupportedThe bundled integration path is tested against RateLoop's own contracts; the pinned-client release smoke test is still outstanding.

The versioned download includes the workspace skills, hooks and server configuration for the testing service. Use --plugin-dir on each launch. No installed-host workspace connection has passed a release smoke test yet; interactive use remains advisory. The generic remote-server path below omits the plugin hooks.

What to expect

Download, check and extract the versioned Claude plugin, then load it with --plugin-dir
Review the plugin and any host trust prompts
Approve the RateLoop OAuth authorization in the browser

Connect your workspace

Copy your message from Connections and paste it into this app. It contains a private, single-use link. Keep the complete message private.

Example connection message

This example shows the instructions your agent receives. Its placeholder link cannot connect a workspace.

Use the RateLoop Workspace plugin's connection skill to connect this session to my RateLoop workspace with the private link below, or call RateLoop's rateloop_connect_workspace tool once with it. If no RateLoop tools are available, stop and tell me to add RateLoop first. Don't open, repeat or share the link. It works once. Check each answer with RateLoop and show its review status.

/connect/aci_...#...

Host-native setup

Download and check the Claude plugin with its hooks; requires Node.js 24 and signed-in Claude Code 2.1.196 or newer on macOS or Linux

mkdir rateloop-claude-0.1.21 &&
cd rateloop-claude-0.1.21 &&
curl --fail --show-error --silent --remote-name https://www.rateloop.ai/integrations/plugins/rateloop-workspace-claude-code-0.1.21-public-alpha.tar.gz &&
curl --fail --show-error --silent --remote-name https://www.rateloop.ai/integrations/plugins/rateloop-workspace-claude-code-0.1.21-public-alpha.tar.gz.sha256 &&
shasum -a 256 -c rateloop-workspace-claude-code-0.1.21-public-alpha.tar.gz.sha256 &&
tar -xzf rateloop-workspace-claude-code-0.1.21-public-alpha.tar.gz &&
claude --plugin-dir ./rateloop-workspace

Checked 2026-09-13 against plugin-bundle@0.1.21; provider-docs-snapshot@2026-09-07.

Generic remote-server registration without RateLoop's hooks; authorize from /mcp

claude mcp add --scope user --transport http rateloop-workspace https://www.rateloop.ai/api/agent/v1/mcp

Checked 2026-07-17 against provider-docs-snapshot@2026-07-17.

Check and recover

The connection is ready only after rateloop_connect_workspace or rateloop_verify_connection verifies it. If tools are missing, check the app's server setup and policy. After access expires or is revoked, complete the app's OAuth prompt, then create a targeted reconnect message in Connections (or a new message if the agent was deleted). Never reuse a claimed link. Recovery guide.

Delivery controls remain advisory; your workflow decides when to send an output.