diff --git a/CLAUDE.md b/CLAUDE.md
index a65a1e6..9cf7961 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -84,7 +84,8 @@ penpot-validate path/to/penpot_file.json
 ### Environment Configuration
 
 Create a `.env` file with:
-```
+
+```env
 PENPOT_API_URL=https://design.penpot.app/api
 PENPOT_USERNAME=your_username
 PENPOT_PASSWORD=your_password
diff --git a/README.md b/README.md
index e79bf81..8ec6901 100644
--- a/README.md
+++ b/README.md
@@ -151,6 +151,12 @@ PORT=5000
 DEBUG=true
 ```
 
+> **⚠️ CloudFlare Protection Notice**: The Penpot cloud site (penpot.app) uses CloudFlare protection that may occasionally block API requests. If you encounter authentication errors or blocked requests:
+> 1. Open your web browser and navigate to [https://design.penpot.app](https://design.penpot.app)
+> 2. Log in to your Penpot account
+> 3. Complete any CloudFlare human verification challenges if prompted
+> 4. Once verified, the API requests should work normally for a period of time
+
 ## Usage
 
 ### Running the MCP Server