Claude Code Integration

Connect Claude Code to your Collab Space workspace to manage tasks, milestones, databases, and more directly from your development environment. This integration uses the Model Context Protocol (MCP) with OAuth authentication.

Overview

Once connected, Claude Code can:

Search issues, documents, meetings, and files in your workspace
Create and update tasks, milestones, and database entries
Manage milestone plans with steps and dependencies
Query your workspace structure and team information

Requirements

Before you begin, ensure you have:

An Enterprise subscription (API access is an Enterprise feature)
Claude Code installed (download here)
Owner or Admin role in your workspace

Setup Guide

Step 1: Create an OAuth Client

Open your workspace in Collab Space
Navigate to Settings > API Access
Click Create OAuth Client
Fill in the details:
- Name: A descriptive name (e.g., "Claude Code - My Laptop")
- Redirect URI: http://localhost:3000/callback
Check Enable MCP (AI Tools) under Additional Scopes
Click Create Client

Step 2: Save Your Credentials

After creating the client, you will see:

Client ID: A unique identifier for your client
Client Secret: A secret key (shown only once)

Important: Copy and save the client secret immediately. You cannot retrieve it later. If you lose it, you will need to rotate the secret or create a new client.

Step 3: Configure Claude Code

Add the Collab Space MCP server to your Claude Code configuration.

Option A: User Configuration (Recommended)

Edit your user configuration file at ~/.claude.json:

Replace YOUR_CLIENT_ID and YOUR_CLIENT_SECRET with the values from Step 2.

Option B: Project Configuration

For project-specific configuration, create .mcp.json in your project root:

Step 4: Authenticate

Restart Claude Code or reload the configuration
When Claude Code connects, it will open your browser for authentication
Sign in to Collab Space if prompted
Authorize the connection

Once authenticated, Claude Code will have access to your workspace tools.

Using Claude Code with Collab Space

Example Commands

Ask Claude Code to interact with your workspace using natural language:

Request	What Happens
"Search for bugs in the authentication module"	Searches issues and documents for relevant matches
"Create a high-priority task to fix the login bug"	Creates a new issue with the specified details
"Show me the milestone plan"	Retrieves and displays your current milestone plan
"Add a step to Milestone 1 for code review"	Adds a new step to the specified milestone
"What tasks are assigned to me?"	Lists issues assigned to your user
"Update TASK-123 status to complete"	Updates the specified issue's status

Working with Multiple Workspaces

If you have access to multiple workspaces, you can specify which one to use:

Search for issues in the "acme-corp" workspace

Claude Code will use the specified workspace code. If not specified, it uses your default workspace.

Available Tools

Claude Code has access to all Collab Space AI tools:

Search & Discovery

Search records across your workspace
Get full content of any record
View workspace hierarchy (teams, members)

Issue Management

List and filter issues
Create, update, and archive issues
Create sub-issues
Manage issue access permissions

Milestone Planning

View and manage milestone plans
Add milestones and steps
Reorder and organize items
Get AI task recommendations

Database Operations

List and view database schemas
Create schemas with custom fields
Add, update, and archive entries

Troubleshooting

"API access requires Enterprise subscription"

Your workspace needs an Enterprise subscription to use the MCP server. Contact your workspace owner to upgrade.

"Invalid or expired token"

Your OAuth token has expired. Claude Code should automatically refresh it, but if issues persist:

Remove the saved token (check Claude Code documentation for token storage location)
Restart Claude Code
Re-authenticate when prompted

"Space not found or not accessible"

You specified a workspace code that does not exist or you do not have access to. Check:

The workspace code is spelled correctly
You are a member of that workspace
Your membership has not been revoked

Connection Timeouts

If requests are timing out:

Check your internet connection
Verify the Collab Space service is operational
Try again in a few moments

Tools Not Appearing

If Claude Code does not show Collab Space tools:

Verify your configuration file syntax is valid JSON
Check that the mcp scope is included in the scopes array
Restart Claude Code completely
Check Claude Code logs for connection errors

Security Best Practices

Protect Your Client Secret

Never commit the client secret to version control
Use environment variables or secure credential storage
Create separate OAuth clients for different machines

Rotate Secrets Regularly

Go to Settings > API Access
Find your OAuth client
Click the rotate icon
Update your Claude Code configuration with the new secret

Revoke Access When Needed

If a device is lost or compromised:

Go to Settings > API Access
Delete the OAuth client for that device
All tokens for that client are immediately invalidated

Frequently Asked Questions

Can multiple people use the same OAuth client? While technically possible, we recommend creating separate OAuth clients for each user and device. This allows you to revoke access individually if needed.

Does Claude Code store my data? Claude Code uses your credentials to access Collab Space on your behalf. Your workspace data is fetched in real-time and is subject to Anthropic's data handling policies. Collab Space data is not used for AI training.

What permissions does Claude Code have? Claude Code has the same permissions as your user account. It can only access and modify records you have permission to view and edit.

Can I use this with other MCP clients? Yes, any MCP-compatible client can connect using the same OAuth configuration. The setup steps will vary by client.

Is there rate limiting? The MCP server has reasonable rate limits to prevent abuse. Normal usage should not encounter limits. If you receive rate limit errors, reduce the frequency of requests.