Skip to main content
use this page when you want an AI agent to configure the edgeful API in a local project. it takes you from zero to a working, verified connection, and you only ever paste your key into a local .env file, never into the chat.
want to use Edgeful directly in Claude Desktop or Claude Web? connect MCP to read reports and build your own in chat. this page is for a coding agent setting up a local project that calls the REST API, which also covers your settings and saved custom reports.
you’ll need two things: a coding agent on your machine, and an edgeful API key (we’ll point you to it below).
1

get a coding agent running

you need a coding agent on your machine — Claude Code, Codex, Cursor, or similar. already have one running? skip to step 2.never installed one, or only ever used AI in a browser? start with never used AI? — it walks you through setting one up in about 10 minutes, then sends you back here for step 2.
2

paste the prompt

paste this into your running agent. it points the agent at a prompt-only setup page, so it does not need to parse this human guide. the agent creates a local .env, makes a verified first call, and guides you through connecting MCP if you want to build and save custom reports.
prompt — paste into your agent
the full agent prompt is also available at ai-agent-setup-prompt. it is intentionally not in the sidebar.
3

add your API key

the prompt sets up everything except your API key, that part’s on you. the agent creates a .env file, then pauses and asks for your key. here’s where to get it:
  1. sign in to edgeful at edgeful.com.
  2. open the API dashboard (edgeful.com/api-dashboard) and go to API Keys.
  3. click generate API key, name it, and copy the value. it starts with ef_live_ and is shown only once.
  4. paste it into the .env file the agent created (after EDGEFUL_API_KEY=), save, and reply done.
paste your key into the .env file, never into the chat.

​
works with

Claude Code, Codex, Cursor, and other coding agents with access to your local project.