syncaida-mcp-server

BruceTrevarthen/syncaida-mcp-server

3.2

If you are the rightful owner of syncaida-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Syncaida MCP Server connects Claude Code to your Syncaida workspace using the Model Context Protocol (MCP) for enhanced project management and diagram generation.

Tools
11
Resources
0
Prompts
0

Syncaida MCP Server

Connect Claude Code to your Syncaida workspace using the Model Context Protocol (MCP).

Features

  • Whiteboard Management: Create, list, update whiteboards
  • Diagram Generation: Create flowcharts and architecture diagrams with AI
  • Task Management: Create and manage tasks
  • Workboard Management: List and create workboards
  • API Token Authentication: Secure access using Syncaida API tokens

Installation

Prerequisites

  • Node.js 18 or higher
  • Claude Code installed
  • Syncaida API token (create one at Users & Security > API Tokens)

Global Installation

claude mcp add --scope user --transport stdio syncaida \
  --env SYNCAIDA_API_URL="http://localhost:8052" \
  --env SYNCAIDA_API_TOKEN="your-token-here" \
  -- npx @scriptedventures/syncaida-mcp-server@latest

Verify Installation

claude mcp list

You should see "syncaida" in the list.

Usage Examples

Create a Whiteboard

"Create a new whiteboard called 'System Architecture'"

Generate a Flowchart

"Create a flowchart on my whiteboard showing a user login process with steps:
Start -> Enter Credentials -> Validate -> Success/Failure -> End"

Create an Architecture Diagram

"Draw an architecture diagram showing: Frontend (React), Backend (FastAPI),
Database (PostgreSQL), and Cache (Redis) with their connections"

List Tasks

"Show me all my tasks"

Create a Task

"Create a high priority task: Implement authentication with due date next Friday"

Available Tools

Whiteboard Tools

  • list_whiteboards - List all whiteboards
  • get_whiteboard - Get whiteboard details
  • create_whiteboard - Create a new whiteboard
  • update_whiteboard - Update whiteboard content

Diagram Tools

  • create_flowchart - Generate flowcharts with auto-layout
  • create_architecture_diagram - Create system architecture diagrams

Task Tools

  • list_tasks - List all tasks
  • create_task - Create a new task
  • update_task - Update task details

Workboard Tools

  • list_workboards - List all workboards
  • create_workboard - Create a new workboard

Configuration

The MCP server requires two environment variables:

  • SYNCAIDA_API_URL: Your Syncaida API URL (default: http://localhost:8052)
  • SYNCAIDA_API_TOKEN: Your Syncaida API token (required)

Development

Local Development

git clone https://github.com/syncaida/mcp-server
cd mcp-server
npm install
npm run build

Testing Locally

claude mcp add --scope user --transport stdio syncaida-dev \
  --env SYNCAIDA_API_URL="http://localhost:8052" \
  --env SYNCAIDA_API_TOKEN="your-token-here" \
  -- node /path/to/syncaida-mcp-npm/dist/index.js

Troubleshooting

MCP server not connecting?

  • Verify your API token is valid
  • Check that SYNCAIDA_API_URL points to your running Syncaida instance
  • Ensure Claude Code has been restarted

Permission errors?

  • Make sure your API token has the necessary scopes
  • Check that the token hasn't been revoked

License

MIT

Support

For issues and questions, visit: https://github.com/syncaida/mcp-server/issues