MCP Setup

MCP Integration

Zenaris provides a Model Context Protocol (MCP) server that allows AI assistants to interact with your invoicing data directly. MCP is supported across 8 popular AI clients.

What is MCP?

MCP (Model Context Protocol) is a standard for connecting AI assistants to external tools and data sources. With Zenaris MCP:

• Read your client, task, and invoice data
• Create and log time entries through natural conversation
• Access real-time business information

Prerequisites

• A Zenaris account with tasks/clients set up
• MCP enabled in your Zenaris subscription
• An MCP API key (generate one from the MCP page in your dashboard)

---

Claude Code

Run this command in your terminal:

claude mcp add --transport http --scope user zenaris https://www.zenaris.co/api/mcp --header "Authorization: Bearer <your-api-key>"

Restart Claude Code after running the command.

---

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "zenaris": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://www.zenaris.co/api/mcp",
        "--header",
        "Authorization: Bearer <your-api-key>"
      ]
    }
  }
}

Requires Node.js installed. Restart Claude Desktop after saving.

---

Cursor

Add this to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "zenaris": {
      "url": "https://www.zenaris.co/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Restart Cursor after saving.

---

VS Code (Copilot)

Add this to .vscode/mcp.json in your project root:

{
  "servers": {
    "zenaris": {
      "type": "http",
      "url": "https://www.zenaris.co/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Reload VS Code after saving.

---

Windsurf

Add this to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "zenaris": {
      "serverUrl": "https://www.zenaris.co/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

Restart Windsurf after saving.

---

Codex CLI

Add this to ~/.codex/config.toml:

[mcp_servers.zenaris]
url = "https://www.zenaris.co/api/mcp"
bearer_token_env = "ZENARIS_API_KEY"

Set the environment variable first: export ZENARIS_API_KEY="<your-api-key>"

---

ChatGPT

• Go to Settings → Actions → Add Action
• Enter the server URL and authentication:

Server URL: https://www.zenaris.co/api/mcp
Authentication: Bearer Token
Token: <your-api-key>

---

Gemini

• Open Settings → Extensions → MCP Servers
• Click Add Server and enter:

Server URL: https://www.zenaris.co/api/mcp
Authentication Type: Bearer Token
API Key: <your-api-key>

---

Verification

Ask your AI assistant: "What clients do I have in Zenaris?"

If connected, it will list your actual clients.