MCP Server

Peaqview MCP Documentation

Connect Claude to your enterprise architecture repository. Query applications, analyze portfolios, extract contracts, and enforce technology governance through natural conversation.

100+Tools Available

8Categories

HTTPSEncrypted

Quick Start

Prerequisites

Peaqview account with workspace access
Service account credentials from your admin
Node.js 18+ installed
Claude Desktop or Claude Code

Install the Proxy

git clone https://github.com/peaqview/mcp-proxy
cd mcp-proxy
npm install

Configure Claude

Add to your Claude Desktop config:

{
  "mcpServers": {
    "peaqview": {
      "command": "npx",
      "args": ["tsx", "local-proxy.ts"],
      "env": {
        "PEAQVIEW_CLIENT_ID": "your_id",
        "PEAQVIEW_CLIENT_SECRET": "your_secret",
        "DEFAULT_WORKSPACE_ID": "your_workspace"
      }
    }
  }
}

Start Using

Open Claude and try:

"Discover my architecture landscape and show portfolio health"

Configuration

Environment Variables

Variable	Required	Description
`PEAQVIEW_CLIENT_ID`	Yes	Service account client ID from your workspace admin
`PEAQVIEW_CLIENT_SECRET`	Yes	Service account client secret
`DEFAULT_WORKSPACE_ID`	Yes	UUID of your Peaqview workspace

Getting Credentials: Contact your Peaqview workspace administrator to create a service account. They will provide you with the client ID, secret, and workspace ID.

Example Prompts

Try these prompts to explore Peaqview capabilities through Claude.

📄

Contract Extraction

"Read the contract PDF on my desktop and extract vendor, pricing, renewal date, and exit clauses. Save it to Peaqview and link it to the matching application."

📊

Portfolio Assessment

"Analyze our application portfolio: which apps have high run costs but low business criticality? Find rationalization candidates and estimate potential savings."

🏗️

Architecture Documentation

"Generate an architecture diagram showing all applications that depend on SAP ERP, including their interfaces and data flows."

🔍

Process Root Cause Analysis

"Our Order-to-Cash process has bottlenecks. Analyze the process mining data, identify slow activities, and find which applications are causing delays."

🛡️

Technology Governance

"I want to add MongoDB to our project. Check if it's approved in our Technology Radar. If it's on hold, what alternatives should I use?"

⚡

Impact Analysis

"We're planning to decommission our legacy CRM. What processes, interfaces, and downstream applications will be affected?"

Available Tools

90+ tools organized by category. Click a category to explore.

discover_architectureComprehensive discovery of architecture landscape

analyze_portfolioDeep portfolio analysis with financial insights

portfolio_analysisFinancial metrics and business criticality distribution

architecture_healthHealth analysis with scoring and recommendations

strategic_insightsGenerate strategic insights and recommendations

detect_anomaliesDetect data quality issues and anomalies

find_rationalization_candidatesFind applications for rationalization

evaluate_build_vs_buyCost-effectiveness analysis for build vs buy

Security & Data Handling

🔒

Encrypted Transport

All data transmitted over HTTPS/TLS encryption

👤

User-Scoped Access

Tools only access data the authenticated user can see

📝

Full Audit Trail

All actions logged with complete traceability

🇪🇺

GDPR Compliant

Enterprise-grade data protection standards

Troubleshooting

Connection Failed

Symptom: "Failed to connect to Peaqview API"

Solution: Verify your CLIENT_ID and CLIENT_SECRET are correct. Check that your service account has access to the specified workspace.

Tools Not Appearing

Symptom: Claude doesn't show Peaqview tools

Solution: Restart Claude Desktop after updating the config. Check the MCP logs at ~/.config/Claude/logs/mcp*.log

Permission Denied

Symptom: "Insufficient permissions" error

Solution: Your service account may have read-only access. Contact your workspace admin to grant write permissions if needed.

Need Help?

Our team is here to help you get the most out of Peaqview MCP.

Contact Support