AI and MCP integration

Connect Scraping Operations to AI agents through its secured MCP server.

6 minDocs version 1.0

In this guide

1Connect the MCP server
2Grant least-privilege scopes
3Approve write operations

In this guide

1Connect the MCP server
2Grant least-privilege scopes
3Approve write operations

Connect the MCP server

The server is available at https://scraping.nordicdevhouse.com/api/mcp. Remote clients discover OAuth automatically and request only the scopes required by the selected tools.

JSON

{
  "type": "mcp",
  "server_label": "nordic-devhouse-mcp",
  "server_url": "https://scraping.nordicdevhouse.com/api/mcp",
  "require_approval": {
    "always": {
      "read_only": false
    },
    "never": {
      "read_only": true
    }
  }
}

Client-specific setup

ChatGPT: In ChatGPT developer mode, create a custom MCP connection and paste the endpoint below. OAuth starts automatically.

URL

https://scraping.nordicdevhouse.com/api/mcp

Claude / Claude Code: Add the remote HTTP server in Claude or Claude Code, then complete OAuth with /mcp.

Shell

claude mcp add --transport http nordic-devhouse-mcp https://scraping.nordicdevhouse.com/api/mcp

Cursor: Add this server to your project or user MCP configuration.

JSON

{
  "mcpServers": {
    "nordic-devhouse-mcp": {
      "url": "https://scraping.nordicdevhouse.com/api/mcp"
    }
  }
}

VS Code: Add this server to .vscode/mcp.json or your user MCP configuration.

JSON

{
  "servers": {
    "nordic-devhouse-mcp": {
      "type": "http",
      "url": "https://scraping.nordicdevhouse.com/api/mcp"
    }
  }
}

Codex: Add the remote Streamable HTTP server with the Codex CLI. Codex stores the connection in your MCP configuration.

Shell

codex mcp add nordic-devhouse-mcp --url https://scraping.nordicdevhouse.com/api/mcp

OpenAI Responses API: Use the remote MCP tool in the Responses API and keep approval enabled for non-read operations.

JSON

{
  "type": "mcp",
  "server_label": "nordic-devhouse-mcp",
  "server_url": "https://scraping.nordicdevhouse.com/api/mcp",
  "require_approval": {
    "always": {
      "read_only": false
    },
    "never": {
      "read_only": true
    }
  }
}

Generated tools

Tool	Mode	Scope	Approval
create_scrape_job	write	scrape:write	required
list_jobs	read	jobs:read	never
get_job	read	jobs:read	never
cancel_job	destructive	jobs:read	required
stream_job_data	read	jobs:read	never
list_events	read	jobs:read	never
create_dataset_export	write	datasets:read	required
get_dataset_export	read	datasets:read	never
list_webhook_deliveries	read	webhooks:write	never
get_observability_metrics	read	jobs:read	never

MCP 2026 runtime

The server is stateless. Use server/discover, follow long-running operations through the Tasks extension, and answer input_required confirmations without changing the sealed requestState value.

Safety model

1
Grant only the API scopes the agent needs
2
Keep the API key server-side
3
Fulfil the signed confirmation round for write and destructive tools
4
Honor returned quota, retry, and circuit-breaker metadata
5
Preserve request and trace identifiers for auditing

Was this page helpful?