Arcstrum Notebook MCP Server

Official Model Context Protocol (MCP) server for Arcstrum Notebook. Enables AI assistants like Claude to interact with your Arcstrum Notebook projects.

✨ Quick Start

Local Development Installation

Since this package is in development, install from the local directory:

# Navigate to the mcp-server directory
cd /Users/jonathanhori/Desktop/Apps/ASNotebook/mcp-server

# Install dependencies and build
npm install
npm run build

# Link globally for development
npm link

# Set up with your API token
asnotebook setup

Alternative: Direct Installation

You can also install directly from the local directory:

# Install from local path
npm install -g /Users/jonathanhori/Desktop/Apps/ASNotebook/mcp-server

# Set up with your API token
asnotebook setup

Production Installation (when published)

npm install -g asnotebook
asnotebook setup

That's it! The setup wizard will:

1. Open your browser to generate an API token
2. Configure the connection
3. Automatically integrate with Claude Code
4. Test everything works

🎯 Features

• Zero Config: Automatic setup and Claude Code integration
• Secure: API token authentication (no passwords stored)
• Complete Access: Projects, views, use cases, test cases, and roles
• Smart CLI: Simple commands for everything

📝 Usage

Once installed, you can ask Claude things like:

• "List my Notebook projects"
• "Create a new authentication view"
• "Add test cases for user login"
• "Update the payment use case description"
• "Show me all failing test cases"

🛠 CLI Commands

asnotebook setup     # Interactive setup wizard
asnotebook status    # Check connection status
asnotebook test      # Test API and list projects
asnotebook enable    # Add to Claude Code
asnotebook disable   # Remove from Claude Code
asnotebook logout    # Remove API token
asnotebook uninstall # Complete removal

🔑 API Token

Get your API token from: https://notebook.arcstrum.com - Go to Settings → API Keys

Tokens are stored securely in ~/.asnotebook/config.json

🤖 Available MCP Tools

Projects

• list_projects - List all your projects
• get_project - Get project details

Views

• create_view - Create a new view
• update_view - Update view details
• delete_view - Remove a view

Use Cases

• create_usecase - Add a use case to a view
• update_usecase - Update use case details
• delete_usecase - Remove a use case

Test Cases

• create_testcase - Add test case to use case
• update_testcase - Update test details
• delete_testcase - Remove a test case

Roles

• create_role - Create a project role
• update_role - Update role details
• delete_role - Remove a role

🔧 Manual Configuration

If automatic setup doesn't work, you can manually configure Claude Code:

1. Find your Claude Code MCP config file:

   • macOS: ~/Library/Application Support/Claude/mcp.json
   • Linux: ~/.config/claude-code/mcp.json
   • Windows: %APPDATA%\Claude\mcp.json

2. Add this configuration:

{
  "mcpServers": {
    "asnotebook": {
      "command": "node",
      "args": ["/path/to/global/node_modules/asnotebook/dist/server.js"],
      "env": {
        "ASNOTEBOOK_CONFIG_PATH": "~/.asnotebook/config.json"
      }
    }
  }
}

🐛 Troubleshooting

"API token not configured"

Run asnotebook setup to configure your token.

"Cannot connect to API"

1. Check your internet connection
2. Verify token is valid: asnotebook test
3. Generate a new token if needed

"Not found in Claude Code"

Run asnotebook enable to add to Claude Code config.

📦 Development

# Clone and install
git clone https://github.com/asnotebook/mcp-server
cd mcp-server
npm install

# Development
npm run dev

# Build
npm run build

# Test locally
npm link
asnotebook setup

📄 License

MIT © Arcstrum Notebook

🤝 Support

• Issues: github.com/asnotebook/mcp-server/issues
• Docs: asnotebook.com/docs/mcp
• Email: [email protected]