diff --git a/src/content/docs/en/pages/devtools/mcp/mcp-cache-testing.mdx b/src/content/docs/en/pages/devtools/mcp/mcp-cache-testing.mdx
new file mode 100644
index 0000000000..efeae54bfe
--- /dev/null
+++ b/src/content/docs/en/pages/devtools/mcp/mcp-cache-testing.mdx
@@ -0,0 +1,447 @@
+---
+title: MCP Cache Testing Guide
+description: >-
+  Comprehensive guide for testing, debugging, and optimizing cache behavior
+  on Azion Platform using MCP tools and cURL commands.
+meta_tags: 'mcp, cache, testing, debugging, optimization, performance'
+namespace: documentation_devtools_mcp_cache_testing
+menu_namespace: devtoolsMenu
+permalink: /documentation/devtools/mcp/cache-testing/
+---
+
+import Code from '~/components/Code/Code.astro'
+
+This guide provides methods for testing, debugging, and optimizing cache behavior on the Azion Edge Platform using MCP tools and direct cURL commands.
+
+---
+
+## Cache debug headers
+
+Enable cache debug headers by including `Pragma: azion-debug-cache` in your requests. This returns detailed cache information.
+
+### Debug headers reference
+
+| Header | Description | Example Values |
+|--------|-------------|----------------|
+| `X-Cache` | Cache status of the request | `HIT`, `MISS`, `EXPIRED`, `UPDATING`, `STALE` |
+| `X-Cache-Key` | The cache key used to store/retrieve the object | `/index.html@@cookie_name=value` |
+| `X-Cache-File` | MD5 hash of the cache key | `a1b2c3d4e5f6789...` |
+| `X-Cache-Since` | Unix timestamp when object was cached | `1640995200` |
+| `X-Cache-Expire` | Unix timestamp when cache expires | `1640995800` |
+| `X-Cache-Expire-In` | Seconds remaining until cache expires | `600` |
+| `X-Cache-Valid` | Configured TTL in seconds | `3600` |
+| `X-Cache-Config` | Azion configuration ID | `1595368520` |
+| `X-Cache-ID` | Unique identifier for this request | `#AECFE66100000000C947B9B3...` |
+
+---
+
+## Basic cache testing with cURL
+
+### Test Azion edge domain
+
+Always start by testing the `.map.azionedge.net` domain directly:
+
+<Code lang="bash" code={`
+# Basic cache status check (headers only)
+curl -H "Pragma: azion-debug-cache" -I "https://xxxxxx.map.azionedge.net/"
+
+# Full response with cache headers
+curl -H "Pragma: azion-debug-cache" -v "https://xxxxxx.map.azionedge.net/"
+`} />
+
+### Test static assets
+
+<Code lang="bash" code={`
+# Test different asset types
+curl -H "Pragma: azion-debug-cache" -I "https://yourdomain.com/style.css"
+curl -H "Pragma: azion-debug-cache" -I "https://yourdomain.com/script.js"
+curl -H "Pragma: azion-debug-cache" -I "https://yourdomain.com/image.jpg"
+
+# Test with query parameters
+curl -H "Pragma: azion-debug-cache" -I "https://yourdomain.com/image.jpg?version=123"
+
+# Test with cookies
+curl -H "Pragma: azion-debug-cache" -H "Cookie: session_id=abc123" -I "https://yourdomain.com/"
+`} />
+
+### Test production domain via Azion edge
+
+<Code lang="bash" code={`
+# Get the Azion edge IP from your edge domain
+AZION_IP=$(dig +short @8.8.8.8 xxxxxx.map.azionedge.net | head -1)
+
+# Test using production hostname via Host header override
+curl -H "Host: yourproductiondomain.com" -H "Pragma: azion-debug-cache" -I "http://$AZION_IP/"
+
+# Or use curl's resolve feature (cleaner)
+curl --resolve "yourproductiondomain.com:443:$AZION_IP" -H "Pragma: azion-debug-cache" -I "https://yourproductiondomain.com/"
+`} />
+
+---
+
+## Cache key testing
+
+### Query parameter variations
+
+<Code lang="bash" code={`
+# Test cache key variations with query parameters
+curl -H "Pragma: azion-debug-cache" -I "https://yourdomain.com/api/data?city=SP&user=john"
+curl -H "Pragma: azion-debug-cache" -I "https://yourdomain.com/api/data?user=john&city=SP"  # Different order
+curl -H "Pragma: azion-debug-cache" -I "https://yourdomain.com/api/data?city=SP&user=john&utm_source=google"  # Extra param
+
+# Compare X-Cache-Key headers to understand:
+# - If query string sorting is enabled
+# - Which parameters affect the cache key
+# - If tracking parameters are ignored
+`} />
+
+### Cookie-based variations
+
+<Code lang="bash" code={`
+# Test cookie-based cache variations
+curl -H "Pragma: azion-debug-cache" -H "Cookie: language=en" -I "https://yourdomain.com/"
+curl -H "Pragma: azion-debug-cache" -H "Cookie: language=pt" -I "https://yourdomain.com/"
+curl -H "Pragma: azion-debug-cache" -H "Cookie: language=en;session_id=123" -I "https://yourdomain.com/"
+
+# Extract and compare cache keys
+curl -H "Pragma: azion-debug-cache" -I "https://yourdomain.com/" 2>/dev/null | grep "X-Cache-Key"
+`} />
+
+---
+
+## Cache performance testing
+
+### Consistent edge location testing
+
+Fix the IP to ensure both requests go to the same edge server:
+
+<Code lang="bash" code={`
+# Get Azion edge IP
+AZION_IP=$(dig +short @8.8.8.8 xxxxxx.map.azionedge.net | head -1)
+echo "Testing with Azion IP: $AZION_IP"
+
+# First request (should be MISS) - with TTFB measurement
+echo "=== FIRST REQUEST (MISS) ==="
+curl --resolve "xxxxxx.map.azionedge.net:443:$AZION_IP" \\
+     -H "Pragma: azion-debug-cache" \\
+     -w "TTFB: %{time_starttransfer}s | Total: %{time_total}s\\n" \\
+     -I "https://xxxxxx.map.azionedge.net/style.css"
+
+# Second request (should be HIT) - with TTFB measurement
+echo "=== SECOND REQUEST (HIT) ==="
+curl --resolve "xxxxxx.map.azionedge.net:443:$AZION_IP" \\
+     -H "Pragma: azion-debug-cache" \\
+     -w "TTFB: %{time_starttransfer}s | Total: %{time_total}s\\n" \\
+     -I "https://xxxxxx.map.azionedge.net/style.css"
+`} />
+
+:::note
+  The TTFB should be significantly lower on the second request when content is served from cache.
+:::
+
+### Provider comparison
+
+<Code lang="bash" code={`
+# Get edge IP for testing
+AZION_IP=$(dig +short @8.8.8.8 xxxxxx.map.azionedge.net | head -1)
+
+# Test Azion edge performance
+echo "=== AZION EDGE PERFORMANCE ==="
+curl --resolve "yourproductiondomain.com:443:$AZION_IP" \\
+     -H "Pragma: azion-debug-cache" \\
+     -w "DNS: %{time_namelookup}s | Connect: %{time_connect}s | TTFB: %{time_starttransfer}s | Total: %{time_total}s\\n" \\
+     -s -o /dev/null "https://yourproductiondomain.com/"
+
+# Test current provider (for comparison)
+echo "=== CURRENT PROVIDER PERFORMANCE ==="
+curl -w "DNS: %{time_namelookup}s | Connect: %{time_connect}s | TTFB: %{time_starttransfer}s | Total: %{time_total}s\\n" \\
+     -s -o /dev/null "https://yourproductiondomain.com/"
+`} />
+
+---
+
+## Network information
+
+Get network information including your IP, resolver, and edge location:
+
+<Code lang="bash" code={`
+curl -L http://netinfo.azion.com/json
+`} />
+
+This provides:
+- Your public IP (useful for searching in Azion logs)
+- DNS resolver being used
+- Azion edge location serving the request
+- Network health status
+
+---
+
+## Real-Time Events monitoring
+
+### Using Azion CLI
+
+<Code lang="bash" code={`
+# View HTTP logs with cache information
+azion logs http --tail --pretty
+
+# View specific application logs
+azion logs http --application-id YOUR_APP_ID --limit 100
+`} />
+
+### Key log variables for cache analysis
+
+| Variable | Description | Example |
+|----------|-------------|---------|
+| `Cache Key` | Cache key used | `/index.html@@cookie_name=value` |
+| `Cache TTL` | Cache duration in seconds | `31536000` |
+| `Upstream Cache Status` | Cache status | `HIT`, `MISS`, `BYPASS`, `EXPIRED`, `STALE` |
+| `Upstream Response Time` | Origin response time | `-` for cached content |
+| `Bytes Sent` | Total bytes delivered | `1024` |
+| `Request Time` | Total processing time | `0.001` |
+
+---
+
+## GraphQL queries for cache analysis
+
+Use MCP's `create_graphql_query` tool or run directly:
+
+<Code lang="graphql" code={`
+query CacheAnalysis {
+  httpMetrics(
+    limit: 1000,
+    filter: {
+      tsRange: { begin: "2024-01-01T00:00:00", end: "2024-01-01T23:59:59" }
+      domain: "yourdomain.com"
+    }
+  ) {
+    cacheStatus
+    bytesSent
+    requestTime
+    status
+    requestMethod
+    uri
+  }
+}
+`} />
+
+### Key performance indicators
+
+- **Cache Hit Ratio**: Should be >80% for static content
+- **Edge Offload**: Percentage of requests served from cache vs origin
+- **Origin Response Time**: Compare cached vs non-cached requests
+- **Bandwidth Savings**: Bytes served from cache vs origin
+
+---
+
+## Cache configuration via CLI
+
+### Create cache settings
+
+<Code lang="bash" code={`
+# Static assets cache
+azion create cache-setting \\
+  --application-id YOUR_APP_ID \\
+  --name "Static Assets" \\
+  --browser-cache-settings "honor" \\
+  --cdn-cache-settings "override" \\
+  --cdn-cache-settings-maximum-ttl 2592000 \\
+  --cache-by-query-string "ignore" \\
+  --cache-by-cookies "ignore" \\
+  --enable-caching-for-post "false"
+
+# Dynamic content cache
+azion create cache-setting \\
+  --application-id YOUR_APP_ID \\
+  --name "API Cache" \\
+  --browser-cache-settings "honor" \\
+  --cdn-cache-settings "override" \\
+  --cdn-cache-settings-maximum-ttl 300 \\
+  --cache-by-query-string "all" \\
+  --cache-by-cookies "whitelist" \\
+  --cookie-names "session_id,language"
+`} />
+
+### Apply via Rules Engine
+
+<Code lang="bash" code={`
+# Cache static assets
+azion create rule \\
+  --application-id YOUR_APP_ID \\
+  --name "Cache Static Assets" \\
+  --criteria "uri matches \\.(jpg|jpeg|png|gif|svg|css|js|woff|woff2|ttf|ico)$" \\
+  --behavior "set_cache_policy" \\
+  --value "Static Assets"
+
+# Bypass cache for authenticated users
+azion create rule \\
+  --application-id YOUR_APP_ID \\
+  --name "Bypass Auth Users" \\
+  --criteria "cookie exists session_id" \\
+  --behavior "bypass_cache" \\
+  --value "true"
+`} />
+
+---
+
+## Cache optimization strategies
+
+### Query string strategy
+
+| Strategy | Use case | Configuration |
+|----------|----------|---------------|
+| **Ignore all** | Static assets | `--cache-by-query-string "ignore"` |
+| **Whitelist** | APIs with functional params | `--cache-by-query-string "whitelist"` with specific params |
+| **Blacklist** | Ignore tracking params | `--cache-by-query-string "blacklist"` with utm_*, fbclid, gclid |
+
+### Cookie strategy
+
+| Strategy | Use case | Configuration |
+|----------|----------|---------------|
+| **Ignore all** | Static content | `--cache-by-cookies "ignore"` |
+| **Whitelist** | Personalized content | `--cache-by-cookies "whitelist"` with language, currency |
+
+### TTL strategy by content type
+
+| Content Type | Recommended TTL | Example |
+|--------------|-----------------|---------|
+| Static assets | 30 days | `2592000` seconds |
+| Semi-static | 1 hour | `3600` seconds |
+| Dynamic | 5 minutes | `300` seconds |
+| Real-time | 30 seconds | `30` seconds |
+
+---
+
+## Automated cache health check script
+
+<Code lang="bash" code={`
+#!/bin/bash
+# cache-health-check.sh
+
+EDGE_DOMAIN="xxxxxx.map.azionedge.net"  # Replace with your edge domain
+ENDPOINTS=("/style.css" "/script.js" "/api/data" "/image.jpg")
+
+echo "Cache Health Check for $EDGE_DOMAIN"
+echo "================================"
+echo "$(date)"
+
+# Get and fix Azion IP for consistent testing
+AZION_IP=$(dig +short @8.8.8.8 "$EDGE_DOMAIN" | head -1)
+echo "Using Azion IP: $AZION_IP"
+echo
+
+for endpoint in "\${ENDPOINTS[@]}"; do
+    echo "Testing: $endpoint"
+    
+    # First request - expect MISS
+    echo -n "  Request 1 (MISS): "
+    RESPONSE1=$(curl --resolve "$EDGE_DOMAIN:443:$AZION_IP" \\
+                    -H "Pragma: azion-debug-cache" \\
+                    -w "TTFB:%{time_starttransfer}s|Total:%{time_total}s" \\
+                    -s -I "https://$EDGE_DOMAIN$endpoint")
+    
+    CACHE1=$(echo "$RESPONSE1" | grep "X-Cache:" | cut -d' ' -f2)
+    TIMING1=$(echo "$RESPONSE1" | tail -1)
+    echo "$CACHE1 ($TIMING1)"
+    
+    sleep 1
+    
+    # Second request - expect HIT
+    echo -n "  Request 2 (HIT):  "
+    RESPONSE2=$(curl --resolve "$EDGE_DOMAIN:443:$AZION_IP" \\
+                    -H "Pragma: azion-debug-cache" \\
+                    -w "TTFB:%{time_starttransfer}s|Total:%{time_total}s" \\
+                    -s -I "https://$EDGE_DOMAIN$endpoint")
+    
+    CACHE2=$(echo "$RESPONSE2" | grep "X-Cache:" | cut -d' ' -f2)
+    TIMING2=$(echo "$RESPONSE2" | tail -1)
+    echo "$CACHE2 ($TIMING2)"
+    
+    # Show cache key
+    CACHE_KEY=$(echo "$RESPONSE2" | grep "X-Cache-Key:" | cut -d' ' -f2-)
+    echo "  Cache Key: $CACHE_KEY"
+    echo
+done
+
+echo "Cache Health Check Complete"
+echo "Summary: Static assets should show MISS -> HIT pattern"
+`} />
+
+---
+
+## Troubleshooting cache issues
+
+### Low cache hit ratio (< 60%)
+
+**Diagnosis:**
+
+<Code lang="bash" code={`
+# Check cache keys being generated
+azion logs http --tail | grep "Cache Key"
+`} />
+
+**Solutions:**
+- Configure `cache-by-query-string` to `ignore` for static content
+- Use `whitelist` for cookies instead of caching by all cookies
+- Implement bypass rules for authenticated users
+
+### Stale content not updating
+
+**Diagnosis:**
+
+<Code lang="bash" code={`
+# Check TTL configuration
+curl -H "Pragma: azion-debug-cache" -I "https://yourdomain.com/content"
+# Look at X-Cache-Valid and X-Cache-Expire headers
+`} />
+
+**Solutions:**
+
+<Code lang="bash" code={`
+# Purge specific content
+azion purge --urls "https://yourdomain.com/content"
+
+# Purge with wildcard
+azion purge --wildcard "https://yourdomain.com/api/*"
+
+# Purge by cache key
+azion purge --cache-key "yourdomain.com/api/data@@lang=en,region=US"
+`} />
+
+### Dynamic content being cached
+
+**Diagnosis:**
+
+<Code lang="bash" code={`
+# Test with different user scenarios
+curl -H "Cookie: user_id=123" "https://yourdomain.com/profile"
+curl -H "Cookie: user_id=456" "https://yourdomain.com/profile"
+# If both return same content, it's incorrectly cached
+`} />
+
+**Solutions:**
+- Add bypass rule for personalized content paths
+- Configure proper `cacheByCookie` settings
+- Use shorter TTLs for user-specific content
+
+---
+
+## Best practices
+
+1. **Use `Pragma: azion-debug-cache`** for immediate cache debugging
+2. **Monitor Real-Time Events** for cache behavior analysis
+3. **Test cache key variations** with different parameters/cookies
+4. **Implement tiered TTL strategy** based on content type
+5. **Use stale-while-revalidate** for better availability
+6. **Monitor cache hit ratios** and optimize configurations
+7. **Purge strategically** using wildcards and cache keys
+8. **Test from multiple edge locations** using direct IP connections
+9. **Automate cache health checks** with shell scripts
+10. **Measure performance differences** between cached and non-cached requests
+
+---
+
+## Next steps
+
+- [MCP Configuration Guide](/en/documentation/devtools/mcp/configuration/)
+- [MCP Examples](/en/documentation/devtools/mcp/examples/)
+- [MCP Troubleshooting](/en/documentation/devtools/mcp/troubleshooting/)
diff --git a/src/content/docs/en/pages/devtools/mcp/mcp-configuration.mdx b/src/content/docs/en/pages/devtools/mcp/mcp-configuration.mdx
index aeaab23e47..c96a043515 100644
--- a/src/content/docs/en/pages/devtools/mcp/mcp-configuration.mdx
+++ b/src/content/docs/en/pages/devtools/mcp/mcp-configuration.mdx
@@ -169,6 +169,68 @@ Create `.vscode/mcp.json` in your project root:
 
 ---
 
+## Warp Terminal
+
+Configure MCP in Warp's settings.
+
+### Configuration
+
+Add to Warp MCP settings:
+
+<Code lang="json" code={`
+{
+    "azion": {
+        "command": "npx",
+        "args": [
+            "mcp-remote",
+            "https://mcp.azion.com",
+            "--header",
+            "Authorization: Bearer YOUR_PERSONAL_TOKEN"
+        ]
+    }
+}
+`} />
+
+---
+
+## Kiro Code
+
+Kiro Code supports MCP through its settings file.
+
+### Setup
+
+Create `.kiro/settings/mcp.json`:
+
+<Code lang="json" code={`
+{
+    "servers": {
+        "azion": {
+            "url": "https://mcp.azion.com",
+            "token": "YOUR_PERSONAL_TOKEN"
+        }
+    }
+}
+`} />
+
+---
+
+## OpenCode
+
+OpenCode uses TOML configuration for MCP servers.
+
+### Setup
+
+Create `.codex/config.toml`:
+
+<Code lang="toml" code={`
+[mcp.servers.azion]
+type = "http"
+url = "https://mcp.azion.com"
+auth = "Bearer YOUR_PERSONAL_TOKEN"
+`} />
+
+---
+
 ## Testing your connection
 
 ### Using MCP Inspector
@@ -231,4 +293,6 @@ This endpoint provides access to all MCP tools and resources for interacting wit
 ## Next steps
 
 - [Explore MCP examples](/en/documentation/devtools/mcp/examples/)
-- [Troubleshooting guide](/en/documentation/devtools/mcp/troubleshooting/)
\ No newline at end of file
+- [Troubleshooting guide](/en/documentation/devtools/mcp/troubleshooting/)
+- [Local Development](/en/documentation/devtools/mcp/local-development/)
+- [Cache Testing Guide](/en/documentation/devtools/mcp/cache-testing/)
\ No newline at end of file
diff --git a/src/content/docs/en/pages/devtools/mcp/mcp-examples.mdx b/src/content/docs/en/pages/devtools/mcp/mcp-examples.mdx
index f8c42df5bd..137f8bbdeb 100644
--- a/src/content/docs/en/pages/devtools/mcp/mcp-examples.mdx
+++ b/src/content/docs/en/pages/devtools/mcp/mcp-examples.mdx
@@ -321,4 +321,6 @@ The assistant provides:
 ## Next steps
 
 - [Configure MCP](/en/documentation/devtools/mcp/configuration/)
-- [Troubleshooting guide](/en/documentation/devtools/mcp/troubleshooting/)
\ No newline at end of file
+- [Troubleshooting guide](/en/documentation/devtools/mcp/troubleshooting/)
+- [Local Development](/en/documentation/devtools/mcp/local-development/)
+- [Cache Testing Guide](/en/documentation/devtools/mcp/cache-testing/)
\ No newline at end of file
diff --git a/src/content/docs/en/pages/devtools/mcp/mcp-local-development.mdx b/src/content/docs/en/pages/devtools/mcp/mcp-local-development.mdx
new file mode 100644
index 0000000000..4fdfcdb72d
--- /dev/null
+++ b/src/content/docs/en/pages/devtools/mcp/mcp-local-development.mdx
@@ -0,0 +1,224 @@
+---
+title: MCP Local Development
+description: >-
+  Set up a local development environment for Azion MCP server, including
+  cloning, building, and deploying your own instance.
+meta_tags: 'mcp, local development, setup, deployment, contributing'
+namespace: documentation_devtools_mcp_local_development
+menu_namespace: devtoolsMenu
+permalink: /documentation/devtools/mcp/local-development/
+---
+
+import Code from '~/components/Code/Code.astro'
+
+This guide covers how to set up a local development environment for the Azion MCP server, useful for testing, customization, or contributing to the project.
+
+---
+
+## Prerequisites
+
+Before starting, ensure you have:
+
+- **Node.js 20+** installed
+- **Yarn** package manager
+- **Azion CLI** installed: [how to download](https://www.azion.com/en/documentation/products/azion-cli/overview/)
+- **Git** for cloning the repository
+- **OpenAI API Key** (required for AI features in local development)
+
+---
+
+## Setup
+
+### 1. Clone the repository
+
+<Code lang="bash" code={`
+git clone https://github.com/aziontech/azion-copilot-api.git
+cd azion-copilot-api/mcp
+`} />
+
+### 2. Install dependencies
+
+<Code lang="bash" code={`
+yarn install
+`} />
+
+### 3. Configure environment variables
+
+<Code lang="bash" code={`
+# Required for AI features
+export OPENAI_API_KEY="your_openai_key"
+
+# Optional: Fast pass authentication for Azion Copilot integration
+export MCP_COPILOT_SERVER_TOKEN="your_token"
+`} />
+
+### 4. Build the server
+
+<Code lang="bash" code={`
+azion build
+`} />
+
+---
+
+## Running locally
+
+Start the development server:
+
+<Code lang="bash" code={`
+azion dev
+# Server will be available at http://localhost:3333
+`} />
+
+### Connect your code assistant
+
+Once the server is running, configure your code assistant to use the local endpoint:
+
+<Code lang="bash" code={`
+# Claude Code example
+claude mcp add "azion-mcp-local" "http://localhost:3333" -t http -H "Authorization: Bearer YOUR_PERSONAL_TOKEN"
+`} />
+
+---
+
+## Personal deployment
+
+Deploy your own instance of the MCP server to Azion Platform.
+
+### 1. Create personal configuration
+
+<Code lang="bash" code={`
+# Create personal configuration directory
+mkdir -p azion/personal
+
+# Link your project
+azion link
+
+# Build with personal config
+azion build --config-dir azion/personal
+`} />
+
+### 2. Deploy
+
+<Code lang="bash" code={`
+azion deploy --config-dir azion/personal
+`} />
+
+### 3. Configure environment variables
+
+After deployment, add the required environment variables in Azion Console:
+
+1. Navigate to your application in [Azion Console](https://console.azion.com)
+2. Go to **Environment Variables**
+3. Add `OPENAI_API_KEY` with your OpenAI API key
+
+### 4. Use your personal URL
+
+Update your MCP configuration to use your personal deployment URL instead of the production endpoint.
+
+---
+
+## Testing
+
+### Using MCP Inspector
+
+Test your local or personal deployment with MCP Inspector:
+
+<Code lang="bash" code={`
+# Install MCP Inspector
+npm install -g @modelcontextprotocol/inspector
+
+# Run the inspector
+npx @modelcontextprotocol/inspector
+`} />
+
+In the Inspector interface:
+
+1. Select **streamable-http** as transport type
+2. Enter your URL: `http://localhost:3333` (local) or your personal deployment URL
+3. Add authentication header: `Authorization: Bearer YOUR_PERSONAL_TOKEN`
+4. Click **Connect** and test available tools
+
+### Test with Node.js directly
+
+<Code lang="bash" code={`
+npx @modelcontextprotocol/inspector node build/index.js
+`} />
+
+---
+
+## Project structure
+
+The MCP server project is organized as follows:
+
+| Directory/File | Description |
+|----------------|-------------|
+| `src/index.ts` | Main entry point |
+| `src/core/` | Core functionality |
+| `src/core/tools.ts` | Tool definitions |
+| `src/core/resources.ts` | Resource definitions |
+| `src/core/prompts.ts` | Prompt definitions |
+| `src/middlewares/auth.ts` | Authentication middleware |
+| `src/helpers/utils.ts` | Helper functions |
+| `azion/production` | Production environment configuration |
+| `azion/stage` | Stage environment configuration |
+
+---
+
+## Configuration directories
+
+The project includes predefined configuration directories:
+
+- **`azion/production`**: Production environment configuration
+- **`azion/stage`**: Stage environment configuration
+- **`azion/personal`**: Your personal configuration (create this)
+
+:::note
+  Never modify the `production` or `stage` directories. Always use a personal configuration for development.
+:::
+
+---
+
+## Authentication methods
+
+The MCP server supports multiple authentication methods:
+
+| Method | Description | Format |
+|--------|-------------|--------|
+| **Fast Pass Token** | Internal token for Azion Copilot | Set via `MCP_COPILOT_SERVER_TOKEN` env var |
+| **Personal Tokens** | Azion Personal Tokens | Format: `azion[a-zA-Z0-9]{35}` (40 chars) |
+| **OAuth Tokens** | Bearer tokens from SSO OAuth flow | Validated against `/oauth/userinfo` |
+| **JWT Tokens** | Bearer tokens for v4 API | Validated against `/v4/account/auth/token` |
+
+Token detection order: JWT first for Bearer tokens, then OAuth if JWT fails.
+
+---
+
+## Troubleshooting local development
+
+### Server won't start
+
+1. Verify Node.js version: `node --version` (must be 20+)
+2. Check if port 3333 is available
+3. Ensure all dependencies are installed: `yarn install`
+
+### Authentication errors
+
+1. Verify your Personal Token is valid
+2. Check the `OPENAI_API_KEY` is set correctly
+3. Ensure the authorization header format is correct
+
+### Build failures
+
+<Code lang="bash" code={`
+# Clean and rebuild
+rm -rf build/
+azion build
+`} />
+
+---
+
+## Next steps
+
+- [MCP Configuration Guide](/en/documentation/devtools/mcp/configuration/)
+- [MCP Examples](/en/documentation/devtools/mcp/examples/)
+- [MCP Troubleshooting](/en/documentation/devtools/mcp/troubleshooting/)
diff --git a/src/content/docs/en/pages/devtools/mcp/mcp-overview.mdx b/src/content/docs/en/pages/devtools/mcp/mcp-overview.mdx
index 67bd023534..21782e1fde 100644
--- a/src/content/docs/en/pages/devtools/mcp/mcp-overview.mdx
+++ b/src/content/docs/en/pages/devtools/mcp/mcp-overview.mdx
@@ -30,6 +30,17 @@ The Azion MCP server is available at:
 
 **Production URL**: `https://mcp.azion.com`
 
+### Available environments
+
+Choose the appropriate environment based on your needs:
+
+| Environment | URL | Use case |
+|-------------|-----|----------|
+| **Production** | `https://mcp.azion.com` | Production console, main branch |
+| **Stage** | `https://stage-mcp.azion.com` | Stage console, dev branch |
+| **Local Development** | `http://localhost:3333` | Running `azion dev` locally |
+| **Personal Deploy** | Your personal Azion URL | After deploying with `azion deploy --config-dir azion/personal` |
+
 ---
 
 ## Capabilities
@@ -48,6 +59,15 @@ The Azion MCP server provides nine specialized tools:
 | `create_graphql_query` | Build GraphQL queries for analytics |
 | `deploy_azion_static_site` | Get guides for deploying static sites |
 
+### MCP Resources
+
+For clients supporting the MCP Resources Protocol, the following resources are available:
+
+| Resource URI | Description |
+|--------------|-------------|
+| `azion://static-site/deploy/*` | Step-by-step deployment guides |
+| `azion://static-site/test-cache/*` | Cache testing workflows |
+
 ---
 
 ## Requirements
@@ -63,4 +83,6 @@ The Azion MCP server provides nine specialized tools:
 - [MCP Configuration Guide](/en/documentation/devtools/mcp/configuration/)
 - [MCP Examples](/en/documentation/devtools/mcp/examples/)
 - [MCP Troubleshooting](/en/documentation/devtools/mcp/troubleshooting/)
+- [MCP Local Development](/en/documentation/devtools/mcp/local-development/)
+- [MCP Cache Testing](/en/documentation/devtools/mcp/cache-testing/)
 - [Model Context Protocol Specification](https://modelcontextprotocol.io)
\ No newline at end of file
diff --git a/src/content/docs/en/pages/devtools/mcp/mcp-troubleshooting.mdx b/src/content/docs/en/pages/devtools/mcp/mcp-troubleshooting.mdx
index 7de2868e5b..0c833ac59d 100644
--- a/src/content/docs/en/pages/devtools/mcp/mcp-troubleshooting.mdx
+++ b/src/content/docs/en/pages/devtools/mcp/mcp-troubleshooting.mdx
@@ -290,20 +290,75 @@ This guide helps resolve common issues with MCP configuration and usage.
 
 ---
 
-## Getting help
+## OAuth and SSO issues
 
-If issues persist after trying these solutions:
+### Token validation fails
 
-1. **Contact support**:
-   - Include error messages
-   - Specify code assistant and version
-   - Provide configuration (without tokens)
-   - Describe steps to reproduce
+**Symptoms:**
+- "Invalid token" after OAuth flow
+- UserInfo returns 401
 
-2. **Community resources**:
-   - [Azion Discord](https://discord.gg/azion)
-   - [Azion Forum](https://forum.azion.com)
+**Solutions:**
 
-:::note
-  When reporting issues, never include your Personal Token in logs or screenshots.
-:::
+1. **Verify token format**:
+   - Ensure the token is sent with `Bearer` prefix
+   - Check if using correct SSO domain (production vs stage)
+
+2. **Check token expiration**:
+   - OAuth tokens expire after a set period
+   - Request a new token if expired
+
+3. **Verify SSO endpoints**:
+   - Production: `https://sso.azion.com/oauth/*`
+   - Stage: `https://stage-sso.azion.com/oauth/*`
+
+### Client not authorized
+
+**Solutions:**
+
+1. Verify client ID and secret are correct
+2. Check redirect URI matches exactly what's configured in SSO
+3. Ensure required scopes are enabled for the client
+
+---
+
+## Environment-specific issues
+
+### Stage environment not responding
+
+**Solutions:**
+
+1. **Verify URL**:
+   - Stage URL: `https://stage-mcp.azion.com`
+   - Production URL: `https://mcp.azion.com`
+
+2. **Check environment status**:
+   - Stage may have different availability than production
+   - Use production for critical workflows
+
+### Local development issues
+
+**Solutions:**
+
+1. **Verify server is running**:
+
+<Code lang="bash" code={`# Check if azion dev is running
+curl http://localhost:3333`} />
+
+2. **Check environment variables**:
+
+<Code lang="bash" code={`# Required for local development
+echo $OPENAI_API_KEY`} />
+
+3. **Restart local server**:
+
+<Code lang="bash" code={`# Stop and restart
+azion dev`} />
+
+---
+
+## Next steps
+
+   - [MCP Local Development](/en/documentation/devtools/mcp/local-development/)
+   - [MCP Cache Testing](/en/documentation/devtools/mcp/cache-testing/)
+   
diff --git a/src/content/docs/pt-br/pages/devtools/mcp/mcp-configuracao.mdx b/src/content/docs/pt-br/pages/devtools/mcp/mcp-configuracao.mdx
index c0b104fe4c..ab602606ee 100644
--- a/src/content/docs/pt-br/pages/devtools/mcp/mcp-configuracao.mdx
+++ b/src/content/docs/pt-br/pages/devtools/mcp/mcp-configuracao.mdx
@@ -159,6 +159,62 @@ O suporte MCP no VS Code pode requerer extensões adicionais. Verifique o market
 
 ---
 
+## Warp Terminal
+
+Configure o MCP nas configurações do Warp.
+
+### Configuração
+
+Adicione às configurações MCP do Warp:
+
+<Code lang="json" code={`{
+    "azion": {
+        "command": "npx",
+        "args": [
+            "mcp-remote",
+            "https://mcp.azion.com",
+            "--header",
+            "Authorization: Bearer SEU_PERSONAL_TOKEN"
+        ]
+    }
+}`} />
+
+---
+
+## Kiro Code
+
+O Kiro Code suporta MCP através de seu arquivo de configurações.
+
+### Configuração
+
+Crie `.kiro/settings/mcp.json`:
+
+<Code lang="json" code={`{
+    "servers": {
+        "azion": {
+            "url": "https://mcp.azion.com",
+            "token": "SEU_PERSONAL_TOKEN"
+        }
+    }
+}`} />
+
+---
+
+## OpenCode
+
+O OpenCode usa configuração TOML para servidores MCP.
+
+### Configuração
+
+Crie `.codex/config.toml`:
+
+<Code lang="toml" code={`[mcp.servers.azion]
+type = "http"
+url = "https://mcp.azion.com"
+auth = "Bearer SEU_PERSONAL_TOKEN"`} />
+
+---
+
 ## Testando sua conexão
 
 ### Usando o MCP Inspector
@@ -221,4 +277,6 @@ Desenvolvimento local requer executar o servidor MCP localmente. Veja o [reposit
 ## Próximos passos
 
 - [Explorar exemplos MCP](/pt-br/documentacao/devtools/mcp/exemplos/)
-- [Guia de solução de problemas](/pt-br/documentacao/devtools/mcp/solucao-de-problemas/)
\ No newline at end of file
+- [Guia de solução de problemas](/pt-br/documentacao/devtools/mcp/solucao-de-problemas/)
+- [Desenvolvimento Local](/pt-br/documentacao/devtools/mcp/desenvolvimento-local/)
+- [Guia de Teste de Cache](/pt-br/documentacao/devtools/mcp/teste-cache/)
\ No newline at end of file
diff --git a/src/content/docs/pt-br/pages/devtools/mcp/mcp-desenvolvimento-local.mdx b/src/content/docs/pt-br/pages/devtools/mcp/mcp-desenvolvimento-local.mdx
new file mode 100644
index 0000000000..1ba2c59a72
--- /dev/null
+++ b/src/content/docs/pt-br/pages/devtools/mcp/mcp-desenvolvimento-local.mdx
@@ -0,0 +1,202 @@
+---
+title: Desenvolvimento Local MCP
+description: >-
+  Configure um ambiente de desenvolvimento local para o servidor MCP da Azion,
+  incluindo clonagem, build e deploy de sua própria instância.
+meta_tags: 'mcp, desenvolvimento local, setup, deployment, contribuição'
+namespace: documentation_devtools_mcp_local_development
+menu_namespace: devtoolsMenu
+permalink: /documentacao/devtools/mcp/desenvolvimento-local/
+---
+
+import Code from '~/components/Code/Code.astro'
+
+Este guia cobre como configurar um ambiente de desenvolvimento local para o servidor MCP da Azion, útil para testes, customização ou contribuição ao projeto.
+
+---
+
+## Pré-requisitos
+
+Antes de começar, certifique-se de ter:
+
+- **Node.js 20+** instalado
+- **Yarn** gerenciador de pacotes
+- **Azion CLI** instalado: [como baixar](https://www.azion.com/pt-br/documentacao/produtos/azion-cli/visao-geral/)
+- **Git** para clonar o repositório
+- **Chave de API OpenAI** (necessária para recursos de IA no desenvolvimento local)
+
+---
+
+## Configuração
+
+### 1. Clonar o repositório
+
+<Code lang="bash" code={`git clone https://github.com/aziontech/azion-copilot-api.git
+cd azion-copilot-api/mcp`} />
+
+### 2. Instalar dependências
+
+<Code lang="bash" code={`yarn install`} />
+
+### 3. Configurar variáveis de ambiente
+
+<Code lang="bash" code={`# Necessário para recursos de IA
+export OPENAI_API_KEY="sua_chave_openai"
+
+# Opcional: Autenticação Fast Pass para integração com Azion Copilot
+export MCP_COPILOT_SERVER_TOKEN="seu_token"`} />
+
+### 4. Build do servidor
+
+<Code lang="bash" code={`azion build`} />
+
+---
+
+## Executando localmente
+
+Inicie o servidor de desenvolvimento:
+
+<Code lang="bash" code={`azion dev
+# O servidor estará disponível em http://localhost:3333`} />
+
+### Conectar seu assistente de código
+
+Uma vez que o servidor esteja rodando, configure seu assistente de código para usar o endpoint local:
+
+<Code lang="bash" code={`# Exemplo com Claude Code
+claude mcp add "azion-mcp-local" "http://localhost:3333" -t http -H "Authorization: Bearer SEU_PERSONAL_TOKEN"`} />
+
+---
+
+## Deploy pessoal
+
+Faça deploy de sua própria instância do servidor MCP na Plataforma Azion.
+
+### 1. Criar configuração pessoal
+
+<Code lang="bash" code={`# Criar diretório de configuração pessoal
+mkdir -p azion/personal
+
+# Vincular seu projeto
+azion link
+
+# Build com configuração pessoal
+azion build --config-dir azion/personal`} />
+
+### 2. Deploy
+
+<Code lang="bash" code={`azion deploy --config-dir azion/personal`} />
+
+### 3. Configurar variáveis de ambiente
+
+Após o deploy, adicione as variáveis de ambiente necessárias no Console Azion:
+
+1. Navegue até sua aplicação no [Console Azion](https://console.azion.com)
+2. Vá para **Variáveis de Ambiente**
+3. Adicione `OPENAI_API_KEY` com sua chave de API OpenAI
+
+### 4. Usar sua URL pessoal
+
+Atualize sua configuração MCP para usar a URL do seu deploy pessoal em vez do endpoint de produção.
+
+---
+
+## Testes
+
+### Usando o MCP Inspector
+
+Teste seu deploy local ou pessoal com o MCP Inspector:
+
+<Code lang="bash" code={`# Instalar MCP Inspector
+npm install -g @modelcontextprotocol/inspector
+
+# Executar o inspector
+npx @modelcontextprotocol/inspector`} />
+
+Na interface do Inspector:
+
+1. Selecione **streamable-http** como tipo de transporte
+2. Digite sua URL: `http://localhost:3333` (local) ou sua URL de deploy pessoal
+3. Adicione o header de autenticação: `Authorization: Bearer SEU_PERSONAL_TOKEN`
+4. Clique em **Connect** e teste as ferramentas disponíveis
+
+### Testar diretamente com Node.js
+
+<Code lang="bash" code={`npx @modelcontextprotocol/inspector node build/index.js`} />
+
+---
+
+## Estrutura do projeto
+
+O projeto do servidor MCP está organizado da seguinte forma:
+
+| Diretório/Arquivo | Descrição |
+|-------------------|-----------|
+| `src/index.ts` | Ponto de entrada principal |
+| `src/core/` | Funcionalidade central |
+| `src/core/tools.ts` | Definições de ferramentas |
+| `src/core/resources.ts` | Definições de recursos |
+| `src/core/prompts.ts` | Definições de prompts |
+| `src/middlewares/auth.ts` | Middleware de autenticação |
+| `src/helpers/utils.ts` | Funções auxiliares |
+| `azion/production` | Configuração do ambiente de produção |
+| `azion/stage` | Configuração do ambiente de stage |
+
+---
+
+## Diretórios de configuração
+
+O projeto inclui diretórios de configuração predefinidos:
+
+- **`azion/production`**: Configuração do ambiente de produção
+- **`azion/stage`**: Configuração do ambiente de stage
+- **`azion/personal`**: Sua configuração pessoal (crie este)
+
+:::note
+Nunca modifique os diretórios `production` ou `stage`. Sempre use uma configuração pessoal para desenvolvimento.
+:::
+
+---
+
+## Métodos de autenticação
+
+O servidor MCP suporta múltiplos métodos de autenticação:
+
+| Método | Descrição | Formato |
+|--------|-----------|---------|
+| **Fast Pass Token** | Token interno para Azion Copilot | Definido via variável de ambiente `MCP_COPILOT_SERVER_TOKEN` |
+| **Personal Tokens** | Personal Tokens Azion | Formato: `azion[a-zA-Z0-9]{35}` (40 caracteres) |
+| **OAuth Tokens** | Bearer tokens do fluxo OAuth SSO | Validado contra `/oauth/userinfo` |
+| **JWT Tokens** | Bearer tokens para autenticação API v4 | Validado contra `/v4/account/auth/token` |
+
+Ordem de detecção de token: JWT primeiro para Bearer tokens, depois OAuth se JWT falhar.
+
+---
+
+## Solução de problemas no desenvolvimento local
+
+### Servidor não inicia
+
+1. Verifique a versão do Node.js: `node --version` (deve ser 20+)
+2. Verifique se a porta 3333 está disponível
+3. Certifique-se de que todas as dependências estão instaladas: `yarn install`
+
+### Erros de autenticação
+
+1. Verifique se seu Personal Token é válido
+2. Verifique se `OPENAI_API_KEY` está definido corretamente
+3. Certifique-se de que o formato do header de autorização está correto
+
+### Falhas no build
+
+<Code lang="bash" code={`# Limpar e reconstruir
+rm -rf build/
+azion build`} />
+
+---
+
+## Próximos passos
+
+- [Guia de Configuração MCP](/pt-br/documentacao/devtools/mcp/configuracao/)
+- [Exemplos MCP](/pt-br/documentacao/devtools/mcp/exemplos/)
+- [Solução de Problemas MCP](/pt-br/documentacao/devtools/mcp/solucao-de-problemas/)
diff --git a/src/content/docs/pt-br/pages/devtools/mcp/mcp-exemplos.mdx b/src/content/docs/pt-br/pages/devtools/mcp/mcp-exemplos.mdx
index 7c6279c77a..e3198cb941 100644
--- a/src/content/docs/pt-br/pages/devtools/mcp/mcp-exemplos.mdx
+++ b/src/content/docs/pt-br/pages/devtools/mcp/mcp-exemplos.mdx
@@ -316,3 +316,5 @@ O assistente fornece:
 
 - [Configurar MCP](/pt-br/documentacao/devtools/mcp/configuracao/)
 - [Guia de solução de problemas](/pt-br/documentacao/devtools/mcp/solucao-de-problemas/)
+- [Desenvolvimento Local](/pt-br/documentacao/devtools/mcp/desenvolvimento-local/)
+- [Guia de Teste de Cache](/pt-br/documentacao/devtools/mcp/teste-cache/)
diff --git a/src/content/docs/pt-br/pages/devtools/mcp/mcp-overview.mdx b/src/content/docs/pt-br/pages/devtools/mcp/mcp-overview.mdx
index adc5c8c543..65a81844d5 100644
--- a/src/content/docs/pt-br/pages/devtools/mcp/mcp-overview.mdx
+++ b/src/content/docs/pt-br/pages/devtools/mcp/mcp-overview.mdx
@@ -30,6 +30,17 @@ O servidor MCP da Azion está disponível em:
 
 **URL de Produção**: `https://mcp.azion.com`
 
+### Ambientes disponíveis
+
+Escolha o ambiente apropriado baseado em suas necessidades:
+
+| Ambiente | URL | Caso de uso |
+|----------|-----|-------------|
+| **Produção** | `https://mcp.azion.com` | Console de produção, branch main |
+| **Stage** | `https://stage-mcp.azion.com` | Console de stage, branch dev |
+| **Desenvolvimento Local** | `http://localhost:3333` | Executando `azion dev` localmente |
+| **Deploy Pessoal** | Sua URL pessoal Azion | Após deploy com `azion deploy --config-dir azion/personal` |
+
 ---
 
 ## Capacidades
@@ -48,6 +59,15 @@ O servidor MCP da Azion fornece nove ferramentas especializadas:
 | `create_graphql_query` | Construir queries GraphQL para analytics |
 | `deploy_azion_static_site` | Obter guias para deploy de sites estáticos |
 
+### MCP Resources
+
+Para clientes que suportam o MCP Resources Protocol, os seguintes recursos estão disponíveis:
+
+| URI do Recurso | Descrição |
+|----------------|-----------|
+| `azion://static-site/deploy/*` | Guias de deploy passo a passo |
+| `azion://static-site/test-cache/*` | Fluxos de trabalho para teste de cache |
+
 ---
 
 ## Requisitos
@@ -63,4 +83,6 @@ O servidor MCP da Azion fornece nove ferramentas especializadas:
 - [Guia de Configuração MCP](/pt-br/documentacao/devtools/mcp/configuracao/)
 - [Exemplos MCP](/pt-br/documentacao/devtools/mcp/exemplos/)
 - [Solução de Problemas MCP](/pt-br/documentacao/devtools/mcp/solucao-de-problemas/)
+- [Desenvolvimento Local MCP](/pt-br/documentacao/devtools/mcp/desenvolvimento-local/)
+- [Teste de Cache MCP](/pt-br/documentacao/devtools/mcp/teste-cache/)
 - [Especificação Model Context Protocol](https://modelcontextprotocol.io)
\ No newline at end of file
diff --git a/src/content/docs/pt-br/pages/devtools/mcp/mcp-solucao-de-problemas.mdx b/src/content/docs/pt-br/pages/devtools/mcp/mcp-solucao-de-problemas.mdx
index f4a6557d3e..068c33d781 100644
--- a/src/content/docs/pt-br/pages/devtools/mcp/mcp-solucao-de-problemas.mdx
+++ b/src/content/docs/pt-br/pages/devtools/mcp/mcp-solucao-de-problemas.mdx
@@ -286,25 +286,74 @@ Nunca compartilhe seu Personal Token ou faça commit dele no controle de versão
 
 ---
 
-## Obtendo ajuda
+## Problemas de OAuth e SSO
 
-Se os problemas persistirem após tentar estas soluções:
+### Falha na validação do token
 
-1. **Verificar GitHub Issues**:
-   - [Repositório Azion Copilot API](https://github.com/aziontech/azion-copilot-api/issues)
-   - Buscar issues existentes
-   - Criar nova issue com detalhes
+**Sintomas:**
+- "Invalid token" após fluxo OAuth
+- UserInfo retorna 401
+
+**Soluções:**
+
+1. **Verificar formato do token**:
+   - Certifique-se de que o token é enviado com prefixo `Bearer`
+   - Verifique se está usando o domínio SSO correto (produção vs stage)
+
+2. **Verificar expiração do token**:
+   - Tokens OAuth expiram após um período definido
+   - Solicite um novo token se expirado
+
+3. **Verificar endpoints SSO**:
+   - Produção: `https://sso.azion.com/oauth/*`
+   - Stage: `https://stage-sso.azion.com/oauth/*`
+
+### Cliente não autorizado
+
+**Soluções:**
+
+1. Verifique se client ID e secret estão corretos
+2. Verifique se a URI de redirect corresponde exatamente ao configurado no SSO
+3. Certifique-se de que os scopes necessários estão habilitados para o cliente
+
+---
+
+## Problemas específicos de ambiente
+
+### Ambiente stage não responde
 
-2. **Contatar suporte**:
-   - Inclua mensagens de erro
-   - Especifique assistente de código e versão
-   - Forneça configuração (sem tokens)
-   - Descreva passos para reproduzir
+**Soluções:**
+
+1. **Verificar URL**:
+   - URL Stage: `https://stage-mcp.azion.com`
+   - URL Produção: `https://mcp.azion.com`
+
+2. **Verificar status do ambiente**:
+   - Stage pode ter disponibilidade diferente de produção
+   - Use produção para fluxos críticos
+
+### Problemas de desenvolvimento local
+
+**Soluções:**
+
+1. **Verificar se o servidor está rodando**:
+
+<Code lang="bash" code={`# Verificar se azion dev está rodando
+curl http://localhost:3333`} />
+
+2. **Verificar variáveis de ambiente**:
+
+<Code lang="bash" code={`# Necessário para desenvolvimento local
+echo $OPENAI_API_KEY`} />
+
+3. **Reiniciar servidor local**:
+
+<Code lang="bash" code={`# Parar e reiniciar
+azion dev`} />
+
+---
 
-3. **Recursos da comunidade**:
-   - [Discord Azion](https://discord.gg/azion)
-   - [Fórum Azion](https://forum.azion.com)
+## Próximos passos
 
-:::note
-Ao reportar problemas, nunca inclua seu Personal Token em logs ou screenshots.
-:::
\ No newline at end of file
+   - [Desenvolvimento Local MCP](/pt-br/documentacao/devtools/mcp/desenvolvimento-local/)
+   - [Teste de Cache MCP](/pt-br/documentacao/devtools/mcp/teste-cache/)
diff --git a/src/content/docs/pt-br/pages/devtools/mcp/mcp-teste-cache.mdx b/src/content/docs/pt-br/pages/devtools/mcp/mcp-teste-cache.mdx
new file mode 100644
index 0000000000..6b1b61c131
--- /dev/null
+++ b/src/content/docs/pt-br/pages/devtools/mcp/mcp-teste-cache.mdx
@@ -0,0 +1,413 @@
+---
+title: Guia de Teste de Cache MCP
+description: >-
+  Guia completo para testar, debugar e otimizar o comportamento de cache
+  na Plataforma Azion usando ferramentas MCP e comandos cURL.
+meta_tags: 'mcp, cache, teste, debug, otimização, performance'
+namespace: documentation_devtools_mcp_cache_testing
+menu_namespace: devtoolsMenu
+permalink: /documentacao/devtools/mcp/teste-cache/
+---
+
+import Code from '~/components/Code/Code.astro'
+
+Este guia fornece métodos para testar, debugar e otimizar o comportamento de cache na Plataforma Edge da Azion usando ferramentas MCP e comandos cURL diretos.
+
+---
+
+## Headers de debug de cache
+
+Habilite os headers de debug de cache incluindo `Pragma: azion-debug-cache` em suas requisições. Isso retorna informações detalhadas sobre o cache.
+
+### Referência de headers de debug
+
+| Header | Descrição | Valores de Exemplo |
+|--------|-----------|-------------------|
+| `X-Cache` | Status do cache da requisição | `HIT`, `MISS`, `EXPIRED`, `UPDATING`, `STALE` |
+| `X-Cache-Key` | A chave de cache usada para armazenar/recuperar o objeto | `/index.html@@cookie_name=value` |
+| `X-Cache-File` | Hash MD5 da chave de cache | `a1b2c3d4e5f6789...` |
+| `X-Cache-Since` | Timestamp Unix de quando o objeto foi cacheado | `1640995200` |
+| `X-Cache-Expire` | Timestamp Unix de quando o cache expira | `1640995800` |
+| `X-Cache-Expire-In` | Segundos restantes até o cache expirar | `600` |
+| `X-Cache-Valid` | TTL configurado em segundos | `3600` |
+| `X-Cache-Config` | ID de configuração Azion | `1595368520` |
+| `X-Cache-ID` | Identificador único para esta requisição | `#AECFE66100000000C947B9B3...` |
+
+---
+
+## Teste básico de cache com cURL
+
+### Testar domínio edge da Azion
+
+Sempre comece testando o domínio `.map.azionedge.net` diretamente:
+
+<Code lang="bash" code={`# Verificação básica de status do cache (apenas headers)
+curl -H "Pragma: azion-debug-cache" -I "https://xxxxxx.map.azionedge.net/"
+
+# Resposta completa com headers de cache
+curl -H "Pragma: azion-debug-cache" -v "https://xxxxxx.map.azionedge.net/"`} />
+
+### Testar assets estáticos
+
+<Code lang="bash" code={`# Testar diferentes tipos de assets
+curl -H "Pragma: azion-debug-cache" -I "https://seudominio.com/style.css"
+curl -H "Pragma: azion-debug-cache" -I "https://seudominio.com/script.js"
+curl -H "Pragma: azion-debug-cache" -I "https://seudominio.com/image.jpg"
+
+# Testar com parâmetros de query
+curl -H "Pragma: azion-debug-cache" -I "https://seudominio.com/image.jpg?version=123"
+
+# Testar com cookies
+curl -H "Pragma: azion-debug-cache" -H "Cookie: session_id=abc123" -I "https://seudominio.com/"`} />
+
+### Testar domínio de produção via edge Azion
+
+<Code lang="bash" code={`# Obter o IP do edge Azion do seu domínio edge
+AZION_IP=$(dig +short @8.8.8.8 xxxxxx.map.azionedge.net | head -1)
+
+# Testar usando hostname de produção via override do header Host
+curl -H "Host: seudominioproducao.com" -H "Pragma: azion-debug-cache" -I "http://$AZION_IP/"
+
+# Ou usar o recurso resolve do curl (mais limpo)
+curl --resolve "seudominioproducao.com:443:$AZION_IP" -H "Pragma: azion-debug-cache" -I "https://seudominioproducao.com/"`} />
+
+---
+
+## Teste de chave de cache
+
+### Variações de parâmetros de query
+
+<Code lang="bash" code={`# Testar variações de chave de cache com parâmetros de query
+curl -H "Pragma: azion-debug-cache" -I "https://seudominio.com/api/data?city=SP&user=john"
+curl -H "Pragma: azion-debug-cache" -I "https://seudominio.com/api/data?user=john&city=SP"  # Ordem diferente
+curl -H "Pragma: azion-debug-cache" -I "https://seudominio.com/api/data?city=SP&user=john&utm_source=google"  # Param extra
+
+# Compare os headers X-Cache-Key para entender:
+# - Se a ordenação de query string está habilitada
+# - Quais parâmetros afetam a chave de cache
+# - Se parâmetros de tracking são ignorados`} />
+
+### Variações baseadas em cookies
+
+<Code lang="bash" code={`# Testar variações de cache baseadas em cookies
+curl -H "Pragma: azion-debug-cache" -H "Cookie: language=en" -I "https://seudominio.com/"
+curl -H "Pragma: azion-debug-cache" -H "Cookie: language=pt" -I "https://seudominio.com/"
+curl -H "Pragma: azion-debug-cache" -H "Cookie: language=en;session_id=123" -I "https://seudominio.com/"
+
+# Extrair e comparar chaves de cache
+curl -H "Pragma: azion-debug-cache" -I "https://seudominio.com/" 2>/dev/null | grep "X-Cache-Key"`} />
+
+---
+
+## Teste de performance de cache
+
+### Teste consistente de localização edge
+
+Fixe o IP para garantir que ambas as requisições vão para o mesmo servidor edge:
+
+<Code lang="bash" code={`# Obter IP do edge Azion
+AZION_IP=$(dig +short @8.8.8.8 xxxxxx.map.azionedge.net | head -1)
+echo "Testando com IP Azion: $AZION_IP"
+
+# Primeira requisição (deve ser MISS) - com medição de TTFB
+echo "=== PRIMEIRA REQUISIÇÃO (MISS) ==="
+curl --resolve "xxxxxx.map.azionedge.net:443:$AZION_IP" \\
+     -H "Pragma: azion-debug-cache" \\
+     -w "TTFB: %{time_starttransfer}s | Total: %{time_total}s\\n" \\
+     -I "https://xxxxxx.map.azionedge.net/style.css"
+
+# Segunda requisição (deve ser HIT) - com medição de TTFB
+echo "=== SEGUNDA REQUISIÇÃO (HIT) ==="
+curl --resolve "xxxxxx.map.azionedge.net:443:$AZION_IP" \\
+     -H "Pragma: azion-debug-cache" \\
+     -w "TTFB: %{time_starttransfer}s | Total: %{time_total}s\\n" \\
+     -I "https://xxxxxx.map.azionedge.net/style.css"`} />
+
+:::note
+O TTFB deve ser significativamente menor na segunda requisição quando o conteúdo é servido do cache.
+:::
+
+### Comparação de provedores
+
+<Code lang="bash" code={`# Obter IP do edge para teste
+AZION_IP=$(dig +short @8.8.8.8 xxxxxx.map.azionedge.net | head -1)
+
+# Testar performance do edge Azion
+echo "=== PERFORMANCE EDGE AZION ==="
+curl --resolve "seudominioproducao.com:443:$AZION_IP" \\
+     -H "Pragma: azion-debug-cache" \\
+     -w "DNS: %{time_namelookup}s | Connect: %{time_connect}s | TTFB: %{time_starttransfer}s | Total: %{time_total}s\\n" \\
+     -s -o /dev/null "https://seudominioproducao.com/"
+
+# Testar provedor atual (para comparação)
+echo "=== PERFORMANCE PROVEDOR ATUAL ==="
+curl -w "DNS: %{time_namelookup}s | Connect: %{time_connect}s | TTFB: %{time_starttransfer}s | Total: %{time_total}s\\n" \\
+     -s -o /dev/null "https://seudominioproducao.com/"`} />
+
+---
+
+## Informações de rede
+
+Obtenha informações de rede incluindo seu IP, resolver e localização edge:
+
+<Code lang="bash" code={`curl -L http://netinfo.azion.com/json`} />
+
+Isso fornece:
+- Seu IP público (útil para buscar nos logs Azion)
+- Resolver DNS sendo usado
+- Localização edge Azion servindo a requisição
+- Status de saúde da rede
+
+---
+
+## Monitoramento de Real-Time Events
+
+### Usando Azion CLI
+
+<Code lang="bash" code={`# Ver logs HTTP com informações de cache
+azion logs http --tail --pretty
+
+# Ver logs de aplicação específica
+azion logs http --application-id SEU_APP_ID --limit 100`} />
+
+### Variáveis de log chave para análise de cache
+
+| Variável | Descrição | Exemplo |
+|----------|-----------|---------|
+| `Cache Key` | Chave de cache usada | `/index.html@@cookie_name=value` |
+| `Cache TTL` | Duração do cache em segundos | `31536000` |
+| `Upstream Cache Status` | Status do cache | `HIT`, `MISS`, `BYPASS`, `EXPIRED`, `STALE` |
+| `Upstream Response Time` | Tempo de resposta da origem | `-` para conteúdo cacheado |
+| `Bytes Sent` | Total de bytes entregues | `1024` |
+| `Request Time` | Tempo total de processamento | `0.001` |
+
+---
+
+## Queries GraphQL para análise de cache
+
+Use a ferramenta `create_graphql_query` do MCP ou execute diretamente:
+
+<Code lang="graphql" code={`query AnaliseCache {
+  httpMetrics(
+    limit: 1000,
+    filter: {
+      tsRange: { begin: "2024-01-01T00:00:00", end: "2024-01-01T23:59:59" }
+      domain: "seudominio.com"
+    }
+  ) {
+    cacheStatus
+    bytesSent
+    requestTime
+    status
+    requestMethod
+    uri
+  }
+}`} />
+
+### Indicadores chave de performance
+
+- **Taxa de Cache Hit**: Deve ser >80% para conteúdo estático
+- **Edge Offload**: Porcentagem de requisições servidas do cache vs origem
+- **Tempo de Resposta da Origem**: Compare requisições cacheadas vs não-cacheadas
+- **Economia de Bandwidth**: Bytes servidos do cache vs origem
+
+---
+
+## Configuração de cache via CLI
+
+### Criar configurações de cache
+
+<Code lang="bash" code={`# Cache de assets estáticos
+azion create cache-setting \\
+  --application-id SEU_APP_ID \\
+  --name "Assets Estaticos" \\
+  --browser-cache-settings "honor" \\
+  --cdn-cache-settings "override" \\
+  --cdn-cache-settings-maximum-ttl 2592000 \\
+  --cache-by-query-string "ignore" \\
+  --cache-by-cookies "ignore" \\
+  --enable-caching-for-post "false"
+
+# Cache de conteúdo dinâmico
+azion create cache-setting \\
+  --application-id SEU_APP_ID \\
+  --name "Cache API" \\
+  --browser-cache-settings "honor" \\
+  --cdn-cache-settings "override" \\
+  --cdn-cache-settings-maximum-ttl 300 \\
+  --cache-by-query-string "all" \\
+  --cache-by-cookies "whitelist" \\
+  --cookie-names "session_id,language"`} />
+
+### Aplicar via Rules Engine
+
+<Code lang="bash" code={`# Cachear assets estáticos
+azion create rule \\
+  --application-id SEU_APP_ID \\
+  --name "Cache Assets Estaticos" \\
+  --criteria "uri matches \\.(jpg|jpeg|png|gif|svg|css|js|woff|woff2|ttf|ico)$" \\
+  --behavior "set_cache_policy" \\
+  --value "Assets Estaticos"
+
+# Bypass de cache para usuários autenticados
+azion create rule \\
+  --application-id SEU_APP_ID \\
+  --name "Bypass Usuarios Auth" \\
+  --criteria "cookie exists session_id" \\
+  --behavior "bypass_cache" \\
+  --value "true"`} />
+
+---
+
+## Estratégias de otimização de cache
+
+### Estratégia de query string
+
+| Estratégia | Caso de uso | Configuração |
+|------------|-------------|--------------|
+| **Ignorar todas** | Assets estáticos | `--cache-by-query-string "ignore"` |
+| **Whitelist** | APIs com params funcionais | `--cache-by-query-string "whitelist"` com params específicos |
+| **Blacklist** | Ignorar params de tracking | `--cache-by-query-string "blacklist"` com utm_*, fbclid, gclid |
+
+### Estratégia de cookies
+
+| Estratégia | Caso de uso | Configuração |
+|------------|-------------|--------------|
+| **Ignorar todos** | Conteúdo estático | `--cache-by-cookies "ignore"` |
+| **Whitelist** | Conteúdo personalizado | `--cache-by-cookies "whitelist"` com language, currency |
+
+### Estratégia de TTL por tipo de conteúdo
+
+| Tipo de Conteúdo | TTL Recomendado | Exemplo |
+|------------------|-----------------|---------|
+| Assets estáticos | 30 dias | `2592000` segundos |
+| Semi-estático | 1 hora | `3600` segundos |
+| Dinâmico | 5 minutos | `300` segundos |
+| Tempo real | 30 segundos | `30` segundos |
+
+---
+
+## Script automatizado de verificação de cache
+
+<Code lang="bash" code={`#!/bin/bash
+# cache-health-check.sh
+
+EDGE_DOMAIN="xxxxxx.map.azionedge.net"  # Substitua pelo seu domínio edge
+ENDPOINTS=("/style.css" "/script.js" "/api/data" "/image.jpg")
+
+echo "Verificação de Saúde do Cache para $EDGE_DOMAIN"
+echo "================================"
+echo "$(date)"
+
+# Obter e fixar IP Azion para teste consistente
+AZION_IP=$(dig +short @8.8.8.8 "$EDGE_DOMAIN" | head -1)
+echo "Usando IP Azion: $AZION_IP"
+echo
+
+for endpoint in "\${ENDPOINTS[@]}"; do
+    echo "Testando: $endpoint"
+    
+    # Primeira requisição - espera MISS
+    echo -n "  Requisição 1 (MISS): "
+    RESPONSE1=$(curl --resolve "$EDGE_DOMAIN:443:$AZION_IP" \\
+                    -H "Pragma: azion-debug-cache" \\
+                    -w "TTFB:%{time_starttransfer}s|Total:%{time_total}s" \\
+                    -s -I "https://$EDGE_DOMAIN$endpoint")
+    
+    CACHE1=$(echo "$RESPONSE1" | grep "X-Cache:" | cut -d' ' -f2)
+    TIMING1=$(echo "$RESPONSE1" | tail -1)
+    echo "$CACHE1 ($TIMING1)"
+    
+    sleep 1
+    
+    # Segunda requisição - espera HIT
+    echo -n "  Requisição 2 (HIT):  "
+    RESPONSE2=$(curl --resolve "$EDGE_DOMAIN:443:$AZION_IP" \\
+                    -H "Pragma: azion-debug-cache" \\
+                    -w "TTFB:%{time_starttransfer}s|Total:%{time_total}s" \\
+                    -s -I "https://$EDGE_DOMAIN$endpoint")
+    
+    CACHE2=$(echo "$RESPONSE2" | grep "X-Cache:" | cut -d' ' -f2)
+    TIMING2=$(echo "$RESPONSE2" | tail -1)
+    echo "$CACHE2 ($TIMING2)"
+    
+    # Mostrar chave de cache
+    CACHE_KEY=$(echo "$RESPONSE2" | grep "X-Cache-Key:" | cut -d' ' -f2-)
+    echo "  Chave de Cache: $CACHE_KEY"
+    echo
+done
+
+echo "Verificação de Saúde do Cache Completa"
+echo "Resumo: Assets estáticos devem mostrar padrão MISS -> HIT"`} />
+
+---
+
+## Solução de problemas de cache
+
+### Baixa taxa de cache hit (< 60%)
+
+**Diagnóstico:**
+
+<Code lang="bash" code={`# Verificar chaves de cache sendo geradas
+azion logs http --tail | grep "Cache Key"`} />
+
+**Soluções:**
+- Configure `cache-by-query-string` para `ignore` para conteúdo estático
+- Use `whitelist` para cookies em vez de cachear por todos os cookies
+- Implemente regras de bypass para usuários autenticados
+
+### Conteúdo stale não atualizando
+
+**Diagnóstico:**
+
+<Code lang="bash" code={`# Verificar configuração de TTL
+curl -H "Pragma: azion-debug-cache" -I "https://seudominio.com/content"
+# Observe os headers X-Cache-Valid e X-Cache-Expire`} />
+
+**Soluções:**
+
+<Code lang="bash" code={`# Purgar conteúdo específico
+azion purge --urls "https://seudominio.com/content"
+
+# Purgar com wildcard
+azion purge --wildcard "https://seudominio.com/api/*"
+
+# Purgar por chave de cache
+azion purge --cache-key "seudominio.com/api/data@@lang=en,region=US"`} />
+
+### Conteúdo dinâmico sendo cacheado
+
+**Diagnóstico:**
+
+<Code lang="bash" code={`# Testar com diferentes cenários de usuário
+curl -H "Cookie: user_id=123" "https://seudominio.com/profile"
+curl -H "Cookie: user_id=456" "https://seudominio.com/profile"
+# Se ambos retornarem o mesmo conteúdo, está incorretamente cacheado`} />
+
+**Soluções:**
+- Adicione regra de bypass para caminhos de conteúdo personalizado
+- Configure as configurações de `cacheByCookie` adequadamente
+- Use TTLs mais curtos para conteúdo específico do usuário
+
+---
+
+## Boas práticas
+
+1. **Use `Pragma: azion-debug-cache`** para debug imediato de cache
+2. **Monitore Real-Time Events** para análise de comportamento de cache
+3. **Teste variações de chave de cache** com diferentes parâmetros/cookies
+4. **Implemente estratégia de TTL em camadas** baseada no tipo de conteúdo
+5. **Use stale-while-revalidate** para melhor disponibilidade
+6. **Monitore taxas de cache hit** e otimize configurações
+7. **Purgue estrategicamente** usando wildcards e chaves de cache
+8. **Teste de múltiplas localizações edge** usando conexões IP diretas
+9. **Automatize verificações de saúde do cache** com scripts shell
+10. **Meça diferenças de performance** entre requisições cacheadas e não-cacheadas
+
+---
+
+## Próximos passos
+
+- [Guia de Configuração MCP](/pt-br/documentacao/devtools/mcp/configuracao/)
+- [Exemplos MCP](/pt-br/documentacao/devtools/mcp/exemplos/)
+- [Solução de Problemas MCP](/pt-br/documentacao/devtools/mcp/solucao-de-problemas/)