Skip to content

Getting Started with Nodebo Gateway

Welcome! This guide will help you get up and running with Nodebo Gateway in 5 minutes.

Prerequisites

  • Account on portal.nodebo.com
  • Claude Code installed
  • Basic understanding of security tools

What You'll Learn

  • ✅ Create an API key for authentication
  • ✅ Configure Claude Code to use Nodebo Gateway
  • ✅ Execute your first skill
  • ✅ Access threat intelligence data

Quick Start (5 minutes)

1. Create an API Key

  1. Go to portal.nodebo.com
  2. Log in with your credentials
  3. Navigate to API Keys section
  4. Click Create New API Key
  5. Give it a name (e.g., "Claude Code")
  6. Copy the generated key

2. Configure Claude Code

Add this to your Claude Code MCP configuration:

{
  "mcpServers": {
    "nodebo-gateway": {
      "type": "http",
      "url": "https://portal.nodebo.com/mcp",
      "headers": {
        "Authorization": "Bearer vmcp_YOUR_API_KEY_HERE"
      }
    }
  }
}

3. Execute Your First Skill

In Claude Code:

Claude: Find the reputation of IP 8.8.8.8

Claude will: 1. Discover available tools from Nodebo 2. Find the "IP Reputation Check" skill 3. Execute with parameters 4. Return threat intelligence results

4. Browse Skills Vault

  1. Go to portal.nodebo.com/skills
  2. Explore available skills
  3. Read documentation
  4. See ratings and reviews

Understanding Authentication

API Keys

API keys are the recommended way to authenticate:

  • Format: vmcp_ followed by random characters
  • Storage: Encrypted in database with Fernet
  • Usage: Add to Authorization: Bearer header
  • Expiration: Optional, can be set per key
  • Revocation: Immediate when deleted

JWT Tokens (Alternative)

For advanced users:

  • Format: JWT token with user claims
  • Duration: 30 minutes access + 7 days refresh
  • Refresh: Automatic refresh token rotation
  • Usage: When API keys not suitable

How Nodebo Works

sequenceDiagram
    participant User as Claude Code User
    participant Gateway as Nodebo Gateway
    participant Vendor as Threat Intel Vendor
    participant Skill as Security Skill

    User->>Gateway: 1. Send API Key + Request
    Gateway->>Gateway: 2. Validate & Decrypt Credentials
    Gateway->>Vendor: 3. Query with User's Credentials
    Vendor->>Gateway: 4. Return Data
    Gateway->>Skill: 5. Process & Format (Optional)
    Skill->>Gateway: 6. Return Result
    Gateway->>User: 7. Return to Claude Code

Step-by-Step

  1. Authenticate: Send API key in header
  2. Discover: Get list of available skills/tools
  3. Execute: Call skill with parameters
  4. Encrypt: Credentials encrypted in-flight and at-rest
  5. Access: Use user's configured credentials for each vendor
  6. Return: Results formatted for Claude Code

Exploring Skills

Search Skills

https://portal.nodebo.com/skills?search=ip+reputation

Filter by Category

  • Threat Intel
  • Incident Response
  • OSINT
  • Malware Analysis
  • Forensics
  • Red Team / Blue Team
  • Automation

View Skill Details

Each skill shows: - Description and documentation - Parameters and expected output - Author and version - Community ratings - Execution examples - Change history

Common Tasks

Check IP Reputation

Claude: What's the reputation of 1.2.3.4?

Nodebo will execute IP reputation skills using VirusTotal, IPInfo, and Censys.

Lookup Domain

Claude: Get threat intelligence for example.com

Analyze File Hash

Claude: Is this hash malicious? SHA256:abc123...

Incident Response

Claude: Create incident response timeline for this event

Next Steps

  1. Skills Vault - Explore available threat intelligence tools
  2. Portal Dashboard - Manage your API keys and configurations
  3. GitHub Repository - View source code and contribute

Getting Help

Ready? Head to the Portal to create your API key and get started!