Merge pull request #235 from apollographql/auth-placeholder

docs: update curl command placeholders

Author: mabuyo

docs/source/guides/auth.mdx

@@ -62,17 +62,18 @@ This guide uses [Auth0](https://auth0.com/) as the Identity Provider.
 
 The Auth0 Connection is the method clients use to authenticate. This guide uses the default **Username-Password-Authentication** connection.
 
-1. In your dashboard, navigate to **Authentication** -> **Database**.
-1. Create the default **Username-Password-Authentication** connection. Click the **Try Connection** button to test it.
-1. Copy the **Connection Identifier** at the top of the page, you need it for the next step. It should start with something like `con_`.
+1. In your Auth0 dashboard, navigate to **Authentication** -> **Database**.
+1. Create the default **Username-Password-Authentication** connection. Click the **Try Connection** button to test it and set up a username and password for later.
+1. Back on your Auth0 dashboard, note the **Connection Identifier** at the top of the page. It should start with something like `con_`. Copy it into a temporary location. This guide refers to it as `<CONNECTION ID>`.
 1. Navigate to **Applications** -> **APIs** -> **Auth0 Management API**.
-1. Click the **API Explorer** tab. Copy the token value, you also need it for the next step.
-1. Run the following `curl` command to promote the connection to domain-level, replacing `CONNECTION_ID` and `MGMT_API_ACCESS_TOKEN` with the values you copied in the previous steps:
+1. Copy the **Identifier** for the Auth0 Management API to a temporary location. It should look something like `dev-123456.us.auth0.com`, where `dev-123456` is your Auth0 tenant ID. This guide refers to it as `<AUTH0 DOMAIN>`.
+1. Click the **API Explorer** tab. Copy the token value to a temporary location. This guide refers to it as `<MGMT API ACCESS TOKEN>`.
+1. Run the following `curl` command to promote the connection to domain level, replacing `<CONNECTION ID>`, `<AUTH0 DOMAIN>`, and `<MGMT API ACCESS TOKEN>` with the values you copied in the previous steps:
 
    ```sh
    curl --request PATCH \
-     --url 'https://dev-p7nxaluy3f2ss4js.us.auth0.com/api/v2/connections/CONNECTION_ID' \
-     --header 'authorization: Bearer MGMT_API_ACCESS_TOKEN' \
+     --url 'https://<AUTH0 DOMAIN>/api/v2/connections/<CONNECTION ID>' \
+     --header 'authorization: Bearer <MGMT API ACCESS TOKEN>' \
      --header 'cache-control: no-cache' \
      --header 'content-type: application/json' \
      --data '{ "is_domain_connection": true }'
@@ -102,7 +103,7 @@ Configure the MCP server to use the Auth0 instance for authentication.
          - read:users # Adjust scopes as needed
    ```
 
-1. Replace the `<AUTH0 DOMAIN>` with your own Auth0 domain. It should look something like `dev-123456.us.auth0.com`, where `dev-123456` is your Auth0 tenant ID.
+1. Replace the `<AUTH0 DOMAIN>` with your own Auth0 domain from earlier.
 
 1. Replace the `<AUTH0 DEFAULT AUDIENCE>` with the matching `Identifier` you set when creating the Auth0 API. In this guide, you used `http://localhost:5000/mcp-example`.
 
@@ -154,7 +155,7 @@ You need a graph's credentials and a valid GraphOS plan to use the router's auth
 
    Note: You don't need to run this command.
 
-1. Retrieve the values for `YOUR_APOLLO_KEY` and `YOUR_APOLLO_GRAPH_REF`.
+1. Retrieve the values for `YOUR_APOLLO_KEY` and `YOUR_APOLLO_GRAPH_REF` from the modal and click **Finish later**.
 
 #### Run the MCP Server and router