Claude Integration

Use Tanda's powerful project management tools directly in Claude conversations! The Tanda MCP (Model Context Protocol) connector enables Claude to interact with your projects, clients, SOWs, and tasks through natural language.

Quick Setup

claude mcp add --transport http tanda \
  https://tanda-mcp-server.fredpope.workers.dev \
  --header "TANDA-API-KEY: YOUR_TANDA_API_TOKEN"

Available Capabilities

The Claude connector provides 50+ tools across these categories:

Project Management

• List projects with filters (status, search)
• View project details including metadata and stats
• Create and update projects
• Archive or delete projects
• Smart navigation through project hierarchy

Client Management

• Search clients by name or industry
• View client details and associated projects
• Create and update client records
• Manage client relationships

Statements of Work (SOWs)

• List and search SOWs by project or status
• View SOW details with full breakdown
• Create SOWs with tasks and criteria
• Update status and track progress
• Navigate hierarchy: Projects → SOWs → Tasks

Task & Test Management

• Manage task items within SOWs
• Create acceptance criteria for tasks
• Define test cases for validation
• Reorder and organize tests
• Track completion status

AI-Powered Features

• Analyze user stories for quality and completeness
• Refine requirements with AI suggestions
• Assess SOW coverage against user stories
• Generate SOWs from user story flows
• Identify gaps in requirements and tests

Smart Navigation

• Drill down through project structures
• Show full hierarchy from project to tests
• Find entities by name across your workspace
• Browse related items contextually

Example Commands

Here are some natural language commands you can use with Claude:

Exploring Projects

"What projects do I have?"
"Show me active projects for client Acme"
"Find the project called 'Website Redesign'"
"What's the status of project XYZ?"

Managing SOWs

"List all SOWs for project ABC"
"Create a new SOW for project XYZ titled 'Phase 2 Development'"
"What tasks are in SOW DEF?"
"Show me the full breakdown of SOW ABC"

Working with Tasks

"Create a task in SOW ABC called 'User Authentication'"
"What acceptance criteria exist for task XYZ?"
"Add a test case for criterion ABC"
"Show me incomplete tasks across all projects"

AI Analysis

"Analyze user story ABC for completeness"
"Is SOW XYZ covering all requirements from user story DEF?"
"Suggest improvements for user story ABC"
"What gaps exist in project XYZ's requirements?"

Security & Privacy

API Token Security

• Tokens are encrypted and never shared with third parties
• Each token is tied to your Tanda user account
• You can revoke tokens anytime from Developer Settings
• Tokens can be scoped to specific permissions (coming soon)

Data Access

• Claude only accesses Tanda when you explicitly use a Tanda tool
• All operations respect your Tanda account permissions
• Organization-scoped: You only see data you have access to
• Audit trail: All API token usage is logged

Best Practices

1. Use descriptive names for your API tokens
2. Create separate tokens for different purposes
3. Rotate tokens regularly for security
4. Revoke unused tokens promptly
5. Never share tokens via email or chat

Troubleshooting

"Authentication required" error

Problem: Claude says authentication is required when using a tool.

Solutions:

• Ensure you pasted the complete API token (starts with tnda_)
• Check the token hasn't been revoked in Developer Settings
• Try creating a new token and using that instead
• Verify you're signed into the correct Tanda organization

"Tool not found" error

Problem: Claude doesn't recognize Tanda tools.

Solutions:

• Verify the connector URL is exactly: https://tanda-mcp-server.fredpope.workers.dev
• Try removing and re-adding the connector
• Refresh Claude.ai and retry
• Check the connector appears in Settings → Connectors

Connector doesn't appear

Problem: Tanda connector not showing up after adding it.

Solutions:

• Refresh the Claude.ai page
• Log out and back in to Claude
• Clear browser cache and try again
• Verify connector was saved (check Settings → Connectors)

"Invalid token" or "Expired token" errors

Problem: API token is rejected or has expired.

Solutions:

• Create a new API token from Developer Settings
• Check you're using a token from the correct organization
• Verify the token hasn't been revoked
• Contact support if issues persist

Rate Limits

The Claude connector is subject to these limits:

• 20 requests per minute per user
• Monthly budget: $50.00 per user
• Alert threshold: 80% of budget

These limits can be adjusted in your organization settings.

Advanced Usage

Combining Multiple Operations

You can ask Claude to perform multiple Tanda operations in sequence:

"Create a new project called 'Mobile App', then create a client 
called 'StartupCo' and associate them, then create an SOW for 
the initial phase"

Context-Aware Queries

Claude maintains context across the conversation:

You: "Show me project ABC"
Claude: [shows project details]
You: "Now list all SOWs for this project"
Claude: [lists SOWs for project ABC]
You: "Create a new task in the first SOW"
Claude: [creates task in first SOW from previous list]

Bulk Operations

For operations on multiple items:

"Show me all projects with status 'active' and client 'Acme'"
"Create acceptance criteria for all tasks in SOW XYZ"
"List tests for all criteria in task ABC"

Feedback & Support

Report Issues

If you encounter problems:

• Email: support@tanda.com
• GitHub: Report an issue

Feature Requests

Want new capabilities in the Claude integration?

• Suggest features in our feedback portal
• Join our community discussions

Updates

Stay informed about new features:

• Check the changelog
• Follow us on Twitter
• Subscribe to our newsletter