Docs / Claude Code

Claude Code

VibeWorks is an MCP server. Claude Code (or any other MCP client) works directly with your projects, tasks, notes and docs – with your permissions.

Setup

In VibeWorks, create a key under My account → Claude Code & API keys.
Copy the command shown and run it in a terminal – it looks like this:

claude mcp add --scope user --transport http vibeworks https://vibeworks.example.com/api/mcp --header "Authorization: Bearer vw_…"

With --scope user the connection applies in all your repositories. Other MCP clients connect to /api/mcp via Streamable HTTP with the same header. Keys can be revoked any time; only a hash is stored.

What Claude can do with it

Tool	What it does
`list_projects`, `get_project`	Projects with status, open tasks, notes and repository
`list_tasks`, `get_task`	Tasks across all projects – e.g. everything due this week
`create_task`, `update_task`	Create tasks and move them to “In progress” or “Done” – issues follow
`create_task_in_projects`	The same task in several projects, by default in all linked to Git
`update_project`	Status, priority, progress, summary
`create_note`, `get_note`	Notes on a project, e.g. a work log
`search`	Full-text search across notes, tasks and docs
`list_docs`, `get_doc`, `create_doc`, `update_doc`	Read and write docs
`get_claude_md`, `list_prompts`, `get_prompt`	A project's CLAUDE.md and your prompt library
`get_repo_status`, `list_problems`	A repository's state (commits, CI, dependencies, repo check, live site) and everything that needs attention
`get_today`, `add_to_today`, `remove_from_today`	Plan the day – picked tasks and suggestions
`start_timer`, `stop_timer`	Track time on a task, also as a focus timer

Try: “Which tasks are open in VibeWorks?” or “Work through the open tasks of project X and write down what you did as a note.” Every change shows up in the project's activity log.

Generate a CLAUDE.md

Project → More actions → Generate CLAUDE.md: description, status, open tasks, pinned notes and the VibeWorks workflow in one file. Adjust, copy or download it and put it into the repository's root – Claude Code reads it on every start.

Prompt library

Under Prompts you collect proven instructions. Placeholders like {{project}}, {{repo}}, {{live}} and {{summary}} are filled in by a chosen project when copying. “Add examples” creates five templates – from code review to “Work through open tasks”.