MCP Server

Overview

The Teamcamp MCP Server enables Claude to interact with your Teamcamp workspace, allowing you to manage projects, tasks, and team activities through natural conversation.

Key Features

• Task Management - Create, update, and view tasks assigned to you

• Project Management - Search and create projects

• Activity Tracking - View project activity history

• Notifications - Check your Teamcamp notifications

• Secure Authentication - OAuth 2.0 based authentication with workspace selection

Getting Started

Step 1: Connect to Teamcamp MCP

Add the Teamcamp MCP server to your Claude Desktop configuration:

{
  "mcpServers": {
    "teamcamp": {
      "url": "https://your-deployment-url.vercel.app/api/mcp"
    }
  }
}

Step 2: Authenticate

When you first use a Teamcamp tool, you'll be prompted to:

1. Log in with your Teamcamp credentials

2. Select a workspace (if you have multiple)

3. Authorize Claude to access your Teamcamp data

Step 3: Start Using

Once authenticated, you can start managing your projects and tasks through conversation with Claude.

Available Tools

1. Get Notifications

Tool Name: get_notifications

Retrieves your Teamcamp notifications.

Example:

2. Get My Tasks

Tool Name: get_mytask

Gets all tasks assigned to you.

Example:

3. Search Projects

Tool Name: search_projects

Search for projects by name.

Example:

4. Create Task

Tool Name: create_task

Creates a new task in a project.

Example:

5. Update Task

Tool Name: update_task

Updates an existing task.

Example:

6. Get Project Activities

Tool Name: project_activities

Gets the activity history for a project.

Example:

7. Create Project

Tool Name: create_project

Creates a new project.

Example:

Example Prompts

Daily Standup Preparation

Project Status Report

Quick Task Creation

Project Setup

Task Updates

Authentication

OAuth 2.0 Flow

The Teamcamp MCP uses OAuth 2.0 for secure authentication:

1. Authorization Request - Claude requests access to your Teamcamp account

2. User Login - You log in with your Teamcamp credentials

3. Workspace Selection - Choose which workspace to connect

4. Token Exchange - Secure tokens are exchanged

5. Access Granted - Claude can now access your Teamcamp data

Security

• Tokens are securely stored and encrypted

• Access can be revoked at any time

• Each session requires re-authentication

Troubleshooting

"Not authenticated" Error

Problem: You see "Error: Not authenticated. Please authenticate first."

Solution:

1. Make sure you've completed the OAuth flow

2. Try disconnecting and reconnecting the MCP server

3. Check if your session has expired

"No workspace selected" Error

Problem: You see "Error: No workspace selected."

Solution:

1. During authentication, make sure to select a workspace

2. If you skipped workspace selection, reconnect and select one

Tool Not Responding

Problem: A tool seems stuck or not responding.

Solution:

1. Tools have a 30-second timeout - wait for the timeout message

2. Check your internet connection

3. Try the request again

Project/Task Not Found

Problem: Can't find a project or task.

Solution:

1. Make sure you're searching with the correct name/ID

2. Verify you have access to the project in Teamcamp

3. Check that you're connected to the correct workspace

API Errors

Problem: You see "Error: 401 Unauthorized" or similar.

Solution:

1. Your session may have expired - reconnect the MCP

2. Verify your Teamcamp account is active

3. Check if the workspace still exists

FAQ

Q: Which Teamcamp workspaces can I access?

A: You can access any workspace where you're a member. During authentication, you'll be asked to select which workspace to connect.

Q: Can I switch workspaces?

A: Currently, you need to disconnect and reconnect the MCP server to switch workspaces.

Q: Is my data secure?

A: Yes. The MCP uses OAuth 2.0 for authentication, and your credentials are never stored by the MCP server. Only secure tokens are used for API access.

Q: What happens if my Teamcamp password changes?

A: You'll need to reconnect the MCP server and authenticate again with your new credentials.

Q: Can I use multiple Teamcamp accounts?

A: The MCP connects to one account at a time. To switch accounts, disconnect and reconnect with different credentials.

Q: Are there rate limits?

A: The MCP respects Teamcamp's API rate limits. If you encounter rate limiting, wait a few minutes before trying again.

Q: Can I create subtasks?

A: Yes, use the create_task tool with the parentTaskId parameter to create subtasks.

Q: How do I find a project ID?

A: Use the search_projects tool to find projects by name. The response includes the project ID.

Support

For issues with the Teamcamp MCP Server:

• Check this help documentation

• Review the Troubleshooting section

• Contact Teamcamp support for account-related issues

Version

• MCP Server Version: 1.0.0

• Last Updated: December 2025