Onboarding Guide

Step 1 — Get invited to a team

xbrain organises every memory item by team slug (e.g. acme-product). You cannot self-register — a team admin must add you first.

bash — admin adds a member# Replace {YOUR_ADMIN_TOKEN} and {TEAM_SLUG}
curl -X POST https://api.grooveos.app/v1/teams/{TEAM_SLUG}/members \
  -H "Authorization: Bearer {YOUR_ADMIN_TOKEN}" \
  -H "X-Team-Scope: {TEAM_SLUG}" \
  -H "Content-Type: application/json" \
  -d '{"email": "alice@example.com", "role": "member"}'

Once added you will receive the team slug from your admin — keep it handy for Step 4.

Step 2 — Sign in with Google

xbrain uses Google OAuth for all user authentication. Open chat.grooveos.app and click Continue with Google.

1. Visit https://chat.grooveos.app
2. Click Continue with Google on the login page
3. Choose the Google account that was invited (must match the email your admin used)
4. You will land on the LibreChat interface — your account is now provisioned

Step 3 — Verify your team membership

After signing in, you need a short-lived Google ID token to call the API. The easiest way is to copy it from the LibreChat network tab, or use the Chrome extension (which fetches it automatically).

For a quick check, open a terminal and call:

bash — list your teamscurl https://api.grooveos.app/v1/teams/my-teams \
  -H "Authorization: Bearer {YOUR_GOOGLE_ID_TOKEN}"

# Expected response:
# [
#   {
#     "slug": "acme-product",
#     "display_name": "Acme · Product",
#     "role": "member"
#   }
# ]

If you see your team slug in the list, you are correctly provisioned. If the list is empty, ask your admin to confirm the invite was sent to the right email.

Step 4 — Generate your personal API token

Claude.ai and ChatGPT cannot use a Google ID token (it expires in 1 hour). Instead, generate a personal API token — a long-lived xbt_… secret that is scoped to your team.

bash — generate a personal API tokencurl -X POST https://api.grooveos.app/v1/me/api-token \
  -H "Authorization: Bearer {YOUR_GOOGLE_ID_TOKEN}" \
  -H "X-Team-Scope: {TEAM_SLUG}" \
  -H "Content-Type: application/json" \
  -d '{"name": "claude-ai", "team_scope": "{TEAM_SLUG}"}'

# Response (token shown ONCE — copy it now):
# {
#   "token": "xbt_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcdef",
#   "id": "...",
#   "team_scope": "acme-product",
#   "name": "claude-ai",
#   "created_at": "2026-05-09T..."
# }

To list your active tokens or revoke one:

bash — list / revoke tokens# List
curl https://api.grooveos.app/v1/me/api-token \
  -H "Authorization: Bearer {YOUR_GOOGLE_ID_TOKEN}"

# Revoke
curl -X DELETE https://api.grooveos.app/v1/me/api-token/{TOKEN_ID} \
  -H "Authorization: Bearer {YOUR_GOOGLE_ID_TOKEN}"

Step 5 — Connect Claude.ai via MCP

xbrain exposes a remote MCP server at https://mcp.grooveos.app/mcp with 9 tools: memory_search, memory_add, tasks_list, task_create, task_update, contacts_search, contact_add, agent_invoke, and team_context.

1. Open claude.ai and sign in
2. Go to Settings → Integrations
3. Click Add integration
4. Fill in the form:

5. Click Save
6. In any Claude.ai conversation, click the integrations icon (top right) and enable xbrain
7. Claude will now see your team's tools and can call them on your behalf

Step 6 — Connect ChatGPT (optional)

xbrain publishes a ChatGPT-compatible OpenAPI spec at https://mcp.grooveos.app/openapi.json. Use it to add xbrain as a Custom Action inside a GPT.

1. Go to My GPTs and open (or create) a GPT
2. Switch to the Configure tab → scroll to Actions
3. Click Create new action
4. Click Import from URL and enter:

url — ChatGPT Actions schemahttps://mcp.grooveos.app/openapi.json

5. Set authentication to API Key, key name Authorization, format Bearer {xbt_…}
6. Click Save — your GPT can now search and add memories

Step 7 — Test the connection

In Claude.ai (with the xbrain integration enabled) or in your GPT, type a test prompt:

prompt — first testSearch the team brain for anything about our product roadmap.

Claude will call memory_search with your query and return results from your team's memory store. If you see results (or an empty-but-successful response), the connection is working.

Try adding a memory:

prompt — add a memoryRemember that our Q3 launch target is July 15th.
Save it to the team brain at truth level WORKING.

Claude calls memory_add and confirms. The item is now in your team's shared memory, visible to every teammate using Claude.ai, ChatGPT, or the LibreChat interface.

Troubleshooting

What's next