> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gdeltcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude

> Connect GDELT Cloud MCP to Claude (web and desktop)

## Overview

Claude supports connecting to MCP servers in supported plans and environments. Use this page as the GDELT Cloud configuration guide, and consult Anthropic's current documentation for Claude-specific availability.

<Info>
  **MCP Server URL:** `https://gdelt-cloud-mcp.fastmcp.app/mcp`
</Info>

## Claude Web (claude.ai)

Connect to GDELT Cloud as a custom connector in the Claude web interface.

<Steps>
  <Step title="Open Connectors settings">
    Go to [claude.ai](https://claude.ai) → **Settings** → **Connectors**
  </Step>

  <Step title="Add custom connector">
    1. Click **Add custom connector** (or "Add external MCP server")
    2. Enter the GDELT Cloud MCP server URL: `https://gdelt-cloud-mcp.fastmcp.app/mcp`
    3. Follow the OAuth consent flow to authorize access with your GDELT Cloud account
  </Step>

  <Step title="Enable in conversations">
    1. After connecting, toggle the connector on
    2. In a new chat, click the **Tools** icon and ensure the GDELT Cloud tools are enabled
    3. Ask questions like *"Show protests in India by day"* or *"Find trade-policy Events and related Stories"*
  </Step>
</Steps>

## Claude Desktop

Claude Desktop supports both remote MCP connections (custom connectors) and local MCP servers.

### Option 1: Remote connector (recommended)

The same custom connector setup works on Claude Desktop:

1. Open Claude Desktop → **Settings** → **Connectors**
2. Add a custom connector with the GDELT Cloud MCP URL
3. Authorize via OAuth

### Option 2: Local proxy (advanced)

For advanced users who want to run a local MCP proxy:

1. Navigate to **Settings** → **Extensions** on Claude Desktop
2. Click **Advanced settings** → **Extension Developer** section
3. Configure a local MCP server that proxies to the GDELT Cloud remote endpoint

See Anthropic's [local MCP server guide](https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop) for details.

## Example Prompts

Once connected, try these in Claude:

* *"Show protests in India by day over the past month."*
* *"Find Stories about AI regulation in the EU and list linked structured Events."*
* *"Show fatal conflict Events in Lebanon this week with citations."*
* *"Look up linked Entities for this Story and explain their relationship to the Events."*
* *"Assess sanctions and market implications from the latest energy corridor disruption signals. Use GDELT Cloud first, then macro finance and prediction markets if useful."*

## Requirements

* A Claude plan and environment with MCP/custom connector support
* GDELT Cloud account with API access
* Valid API key from your [dashboard](https://gdeltcloud.com/dashboard)

## Official Documentation

<CardGroup cols={2}>
  <Card title="Custom Connectors (Remote MCP)" icon="link" href="https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp">
    Anthropic's guide to connecting remote MCP servers as custom connectors
  </Card>

  <Card title="Local MCP Servers" icon="link" href="https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop">
    Setting up local MCP servers on Claude Desktop
  </Card>
</CardGroup>