Claude Code

Getting Started with Claude Code

Set up Claude Code CLI to work with Praximos via MCP

Getting Started with Claude Code

Claude Code is Anthropic's CLI tool that brings Claude directly into your development workflow. When connected to Praximos via MCP, Claude Code can manage your projects, obligations, and team access without leaving the terminal.

Prerequisites

  • A Praximos account with an active API token (generate one here)
  • Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)

Project Setup

1. Create .mcp.json in your project root

{
  "mcpServers": {
    "praximos": {
      "type": "http",
      "url": "https://your-domain.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

2. Add CLAUDE.md for project context

Create a CLAUDE.md file in your project root to give Claude context about your workflow:

# Project Context

This project uses Praximos for obligation tracking.

## Praximos Integration
- Account: my-team
- Default project: my-project
- When creating obligations, always set a due date
- Assign obligations to the appropriate executor

3. Start Claude Code

claude

Claude will automatically discover the Praximos MCP tools and can now interact with your instance.

Example Workflows

Create a project and add obligations

> Create a new Praximos project called "Q2 Launch" and add three obligations:
  1. "Finalize landing page copy" due April 15
  2. "Security audit" due April 20
  3. "Load testing" due April 25

Check project status

> What obligations are pending in my "Q2 Launch" project?

Manage team access

> Grant alice@example.com WRITE access to the "Q2 Launch" project

Tips

  • Be specific: Include project names and dates in your requests
  • Use CLAUDE.md: Set defaults so you don't have to repeat context
  • Check permissions: Claude operates with your token's permissions — it can't do anything you can't do
  • Combine with code: Claude Code can create obligations from TODO comments, track deployment progress, or update project status as part of your dev workflow