Skip to content

docs: Add instructions for Goose as an LLM client on Auth guide #275

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Sep 23, 2025
Merged

docs: Add instructions for Goose as an LLM client on Auth guide #275

Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
3dcee39
docs: Add instructions for Claude on Auth guide
jcaudle Aug 21, 2025
fdb5644
Improve article structure with heading change
jcaudle Aug 26, 2025
3f2b960
Add local Claude Desktop configuration instructions
jcaudle Sep 1, 2025
d684aa5
Change from using Claude to Goose
jcaudle Sep 11, 2025
726342e
Merge branch 'develop' into add-claude-to-auth-guide
jcaudle Sep 11, 2025
5f1f480
fix: heading style
mabuyo Sep 23, 2025
516e67c
edits for simplicity and directness
mabuyo Sep 23, 2025
3c3d138
use an easy-to-skim table for prompts + answers
mabuyo Sep 23, 2025
e1eed61
clarify goose configure with LLM provider
mabuyo Sep 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions docs/source/guides/auth-auth0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -225,6 +225,30 @@

</ExpansionPanel>

### Step 5: Make requests with an MCP Client (Goose)

Check warning on line 228 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L228 

Headings should use sentence case.

```suggestion
### Step 5: Make requests with an MCP client (Goose)
```

We'll use [Goose](https://block.github.io/goose/) as our MCP Client. Goose allows you to choose between many different LLMs and provides some built-in functionality for connecting to MCP servers, called [Extensions](https://block.github.io/goose/docs/getting-started/using-extensions).

Check warning on line 230 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L230 

Avoid using "we" unless it unambiguously refers to Apollo. Use the imperative to instruct the reader.

```suggestion
Use [Goose](https://block.github.io/goose/) as your MCP client. Goose enables you to choose between many different LLMs and provides some built-in functionality for connecting to MCP servers, called [Extensions](https://block.github.io/goose/docs/getting-started/using-extensions).
```

[Install the Goose CLI](https://block.github.io/goose/docs/getting-started/installation), following the instructions for your operating system. Set up the LLM provider of your choice with `goose configure` --> **Configure Providers**. Each provider has its own set of instructions, rate limiting and pricing.

Check warning on line 232 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L232 

The arrow symbol (`-->`) is not standard punctuation and can be unclear. Replace it with a more descriptive instruction. Also, use the Oxford comma for lists of three or more items.

```suggestion
[Install the Goose CLI](https://block.github.io/goose/docs/getting-started/installation), following the instructions for your operating system. Set up the LLM provider of your choice with <code>goose configure</code>, then select **Configure Providers**. Each provider has its own set of instructions, rate limiting, and pricing.
```

Then, continue with the following steps:

1. In your terminal, run `goose configure`.
1. Select or enter the following answers at the prompts:

| Prompt | Answer |
| ----------------------------------------------------------- | ------------------------------------------ |
| "What would you like to configure?" | "Add Extension" |

Check notice on line 241 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L241 

Use bold for the name of a button or other labeled interactive element a user selects. The surrounding quotes are not necessary.

```suggestion
| "What would you like to configure?"                         | **Add Extension**                          |
```
| "What type of extension would you like to add?" | "Command Line Extension" |

Check notice on line 242 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L242 

Use bold for the name of a button or other labeled interactive element a user selects. The surrounding quotes are not necessary.

```suggestion
| "What type of extension would you like to add?"             | **Command Line Extension**                 |
```
| "What's the name of this extension?" | "mcp-auth-quickstart" |

Check warning on line 243 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L243 

Use code font for any value a user inputs into a terminal.

```suggestion
| "What's the name of this extension?"                        | <code>mcp-auth-quickstart</code>                     |
```
| "What command should be run?" | `npx mcp-remote http://127.0.0.1:5000/mcp` |
| Other prompts (timeout, description, environment variables) | Use the default values |

1. To start Goose, type `goose`. This will open a browser window and send you through the auth flow.

Check notice on line 247 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L247 

Use the imperative for instructions and favor the present tense over the future tense for clarity and brevity.

```suggestion
1. Run <code>goose</code> to start the application. This opens a browser window and directs you through the authentication flow.
```
1. Log in to your Auth0 instance and authorize your MCP server to gain access to your tools.
1. In Goose, ask "What astronauts are in space right now?". This question is similar to the `GetAstronautsCurrentlyInSpace` operation from earlier, which fails as unauthenticated without the proper token.
1. Goose will select the `GetAstronautsCurrentlyInSpace` tool and respond with information about the astronauts found in TheSpaceDevs.

Check notice on line 250 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L250 

Favor the present tense over the future tense.

```suggestion
1. Goose selects the <code>GetAstronautsCurrentlyInSpace</code> tool and responds with information about the astronauts found in TheSpaceDevs.
```

## Troubleshooting
Copy link
Contributor Author

@jcaudle jcaudle Sep 11, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are some issues that can arise if any of the above steps go wrong, but I'm not sure how much of them we want to document in this Troubleshooting section. Namely, the ~/.mcp-auth folder may cause Goose to hang on boot and might need to be deleted. If everything goes cleanly, this shouldn't happen, but this and a few other things I ran into while testing this out seem like easy ways to get into trouble for new users.


### Common Issues
Expand Down