better secrets explanation

Author: torresmateo

app/en/home/custom-mcp-server-quickstart/page.mdx

@@ -81,22 +81,29 @@ This generates a complete project with:
 
 ## Setup the secrets in your environment
 
-Secrets can be provided via environment variables.
+Secrets are sensitive strings like passwords, api-keys, or other tokens that grant access to a protected resource or API. Arcade includes the "whisper_secret" tool that requires a secret key to be set in your environment. If the secret is not set, the tool will return an error.
 
-<Tabs items={["Terminal", "Environment File"]}>
+<Tabs items={["Environment Variable", "Terminal"]}>
 <Tabs.Tab>
-You can set the environment variable in your terminal directly with this command:
+You can create a `.env` file in the root of your project and add your secret:
+
+```env filename=".env"
+MY_SECRET_KEY="my-secret-value"
+```
+
+The project includes a `.env.example` file with the secret key name and example value.
+You can rename it to `.env` to start using it.
 
 ```bash
-export MY_SECRET_KEY="my-secret-value"
+mv .env.example .env
 ```
 
 </Tabs.Tab>
 <Tabs.Tab>
-You can create a `.env` file in the root of your project and add your secret:
+You can set the environment variable in your terminal directly with this command:
 
-```env filename=".env"
-MY_SECRET_KEY="my-secret-value"
+```bash
+export MY_SECRET_KEY="my-secret-value"
 ```
 
 </Tabs.Tab>