diff --git a/baton/linear.mdx b/baton/linear.mdx
index cfec5ff4..ff018cf6 100644
--- a/baton/linear.mdx
+++ b/baton/linear.mdx
@@ -34,10 +34,10 @@ Configuring the connector requires you to pass in credentials generated in Linea
 In Linear, click your profile photo and select **Settings**.
 </Step>
 <Step>
-Click **API**.
+In the **Quick search** box, enter `Security & access`, then select the **Security & access** page.
 </Step>
 <Step>
-In the **Personal API keys** section of the page, enter a label such as "C1" and click **Create key**.
+In the **Personal API keys** section of the page, click **New API key**. Enter a label such as "C1", configure the key's permissions and team access, and click **Create**.
 </Step>
 <Step>
 The new API key is generated for you. Carefully copy and save the API key.
diff --git a/product/admin/mcp-server/linear.mdx b/product/admin/mcp-server/linear.mdx
index 54ffa1d6..3dc4dbcb 100644
--- a/product/admin/mcp-server/linear.mdx
+++ b/product/admin/mcp-server/linear.mdx
@@ -93,10 +93,10 @@ Create a personal API key in Linear for the account C1 should run as. For Linear
 Sign in to Linear as the account C1 should run as, then open **Settings** > **Security & access**.
 </Step>
 <Step>
-Under **Personal API keys**, select **Create key**.
+Under **Personal API keys**, select **New API key**.
 </Step>
 <Step>
-Enter a label such as `C1` and select **Create**.
+Enter a label such as `C1`, configure the key's permissions and team access, and select **Create**.
 </Step>
 <Step>
 Copy the key immediately. Linear shows it only once.