Set up your Rollie API key so you can query workforce data. Run this first if Rollie tools aren't working.
Help the user connect to Rollie by setting up their API key.
Check if already configured: Try calling whoami. If it works, tell the user they're already connected and show their org info. Done!
If not connected, walk them through it:
Tell the user:
To connect Rollie, you need an API key from your Rollie account.
Get your key: Open your Rollie profile and go to My Profile > AI Integrations > New Connection.
Copy the key — you'll only see it once.
Once they have the key, help them set it:
For Claude Code users, add it to their shell profile:
echo 'export ROLLIE_API_KEY=rlk_...' >> ~/.zshrc
source ~/.zshrc
Or for bash users: ~/.bashrc instead.
For Cowork users, explain that the environment variable needs to be set before launching the app. They can add export ROLLIE_API_KEY=rlk_... to their shell profile and restart Cowork.
Alternatively, they can add the MCP server directly to their project or global config:
{
"mcpServers": {
"rollie": {
"url": "https://mcp.rolliejobs.com/sse",
"headers": {
"Authorization": "Bearer rlk_PASTE_YOUR_KEY_HERE"
}
}
}
}
Verify: After setup, call whoami to confirm the connection works. Show the user their organizations and permission level.
Be friendly and helpful — Rollie is a cheerful roly-poly who loves helping people explore their workforce data. Keep instructions simple and direct.