mirror of
https://github.com/aljazceru/goose.git
synced 2025-12-17 14:14:26 +01:00
288 lines
8.9 KiB
Markdown
288 lines
8.9 KiB
Markdown
---
|
||
title: Netlify Extension
|
||
description: Add Netlify MCP Server as a Goose Extension
|
||
---
|
||
|
||
import Tabs from '@theme/Tabs';
|
||
import TabItem from '@theme/TabItem';
|
||
import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
|
||
|
||
<YouTubeShortEmbed videoUrl="https://www.youtube.com/embed/iSUNmxOf6gw" />
|
||
|
||
This tutorial covers how to add the [Netlify MCP Server](https://github.com/netlify/netlify-mcp) as a Goose extension to build, deploy, and manage Netlify sites.
|
||
|
||
:::tip TLDR
|
||
<Tabs groupId="interface">
|
||
<TabItem value="ui" label="Goose Desktop" default>
|
||
[Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40netlify%2Fmcp&id=netlify&name=Netlify&description=Build%2C%20deploy%2C%20and%20manage%20sites%20with%20Netlify%27s%20official%20MCP%20server.)
|
||
</TabItem>
|
||
<TabItem value="cli" label="Goose CLI">
|
||
**Command**
|
||
```sh
|
||
npx -y @netlify/mcp
|
||
```
|
||
</TabItem>
|
||
</Tabs>
|
||
:::
|
||
|
||
## Configuration
|
||
|
||
:::info
|
||
Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
|
||
:::
|
||
|
||
Make sure that you are signed in to your Netlify account:
|
||
|
||
```bash
|
||
netlify login
|
||
```
|
||
|
||
### Add Netlify MCP Server
|
||
|
||
<Tabs groupId="interface">
|
||
<TabItem value="ui" label="Goose Desktop" default>
|
||
1. [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40netlify%2Fmcp&id=netlify&name=Netlify&description=Build%2C%20deploy%2C%20and%20manage%20sites%20with%20Netlify%27s%20official%20MCP%20server.)
|
||
2. Press `OK` to confirm the installation
|
||
</TabItem>
|
||
<TabItem value="cli" label="Goose CLI">
|
||
1. Run the `configure` command:
|
||
```sh
|
||
goose configure
|
||
```
|
||
|
||
2. Choose to add a `Command-line Extension`
|
||
```sh
|
||
┌ goose-configure
|
||
│
|
||
◇ What would you like to configure?
|
||
│ Add Extension (Connect to a new extension)
|
||
│
|
||
◆ What type of extension would you like to add?
|
||
│ ○ Built-in Extension
|
||
// highlight-start
|
||
│ ● Command-line Extension (Run a local command or script)
|
||
// highlight-end
|
||
│ ○ Remote Extension (SSE)
|
||
│ ○ Remote Extension (Streaming HTTP)
|
||
└
|
||
```
|
||
|
||
3. Give your extension a name
|
||
```sh
|
||
┌ goose-configure
|
||
│
|
||
◇ What would you like to configure?
|
||
│ Add Extension (Connect to a new extension)
|
||
│
|
||
◇ What type of extension would you like to add?
|
||
│ Command-line Extension
|
||
│
|
||
// highlight-start
|
||
◆ What would you like to call this extension?
|
||
│ netlify
|
||
// highlight-end
|
||
└
|
||
```
|
||
|
||
4. Enter the command
|
||
```sh
|
||
┌ goose-configure
|
||
│
|
||
◇ What would you like to configure?
|
||
│ Add Extension (Connect to a new extension)
|
||
│
|
||
◇ What type of extension would you like to add?
|
||
│ Command-line Extension
|
||
│
|
||
◇ What would you like to call this extension?
|
||
│ netlify
|
||
│
|
||
// highlight-start
|
||
◆ What command should be run?
|
||
│ npx -y @netlify/mcp
|
||
// highlight-end
|
||
└
|
||
```
|
||
|
||
5. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s
|
||
```sh
|
||
┌ goose-configure
|
||
│
|
||
◇ What would you like to configure?
|
||
│ Add Extension (Connect to a new extension)
|
||
│
|
||
◇ What type of extension would you like to add?
|
||
│ Command-line Extension
|
||
│
|
||
◇ What would you like to call this extension?
|
||
│ netlify
|
||
│
|
||
◇ What command should be run?
|
||
│ npx -y @netlify/mcp
|
||
│
|
||
// highlight-start
|
||
◆ Please set the timeout for this tool (in secs):
|
||
│ 300
|
||
// highlight-end
|
||
│
|
||
└
|
||
```
|
||
|
||
6. Choose to add a description. If you select "Yes" here, you will be prompted to enter a description for the extension.
|
||
```sh
|
||
┌ goose-configure
|
||
│
|
||
◇ What would you like to configure?
|
||
│ Add Extension (Connect to a new extension)
|
||
│
|
||
◇ What type of extension would you like to add?
|
||
│ Command-line Extension
|
||
│
|
||
◇ What would you like to call this extension?
|
||
│ netlify
|
||
│
|
||
◇ What command should be run?
|
||
│ npx -y @netlify/mcp
|
||
│
|
||
◇ Please set the timeout for this tool (in secs):
|
||
│ 300
|
||
│
|
||
// highlight-start
|
||
◇ Would you like to add a description?
|
||
│ No
|
||
// highlight-end
|
||
│
|
||
└
|
||
```
|
||
|
||
7. Choose No when asked to add environment variables
|
||
|
||
```sh
|
||
┌ goose-configure
|
||
│
|
||
◇ What would you like to configure?
|
||
│ Add Extension (Connect to a new extension)
|
||
│
|
||
◇ What type of extension would you like to add?
|
||
│ Command-line Extension
|
||
│
|
||
◇ What would you like to call this extension?
|
||
│ netlify
|
||
│
|
||
◇ What command should be run?
|
||
│ npx -y @netlify/mcp
|
||
│
|
||
◇ Please set the timeout for this tool (in secs):
|
||
│ 300
|
||
│
|
||
◇ Would you like to add a description?
|
||
│ No
|
||
│
|
||
// highlight-start
|
||
◆ Would you like to add environment variables?
|
||
│ No
|
||
|
|
||
// highlight-end
|
||
└ Added netlify extension
|
||
```
|
||
|
||
</TabItem>
|
||
</Tabs>
|
||
|
||
## Example Usage
|
||
|
||
In this example, I’ll show you how to use Goose with the Netlify Extension to deploy a web application.
|
||
|
||
### Goose Prompt
|
||
|
||
> Can you deploy my app to Netlify via my GitHub repo?
|
||
|
||
### Goose Output
|
||
|
||
:::note CLI
|
||
|
||
<details>
|
||
<summary>Tool Calls</summary>
|
||
I'll help you deploy your tic-tac-toe app to Netlify from your GitHub repository. Let me first check your Netlify account and then set up the deployment.
|
||
|
||
─── netlify-user-services | netlify ──────────────────────────
|
||
|
||
selectSchema: <br/>
|
||
operation: get-user <br/>
|
||
params:
|
||
|
||
Great! I can see you're logged into Netlify with your GitHub account connected. Now let me create a new Netlify site and deploy your tic-tac-toe app from your GitHub repository.
|
||
|
||
─── netlify-project-services | netlify ──────────────────────────
|
||
|
||
selectSchema:<br/>
|
||
operation: create-new-project<br/>
|
||
params:<br/>
|
||
name: tic-tac-toe-game
|
||
|
||
Let me try a different name for the project:
|
||
|
||
─── netlify-project-services | netlify ──────────────────────────
|
||
|
||
selectSchema:<br/>
|
||
operation: create-new-project<br/>
|
||
params:<br/>
|
||
name: janedoe-tic-tac-toe
|
||
|
||
Perfect! I've created a new Netlify site called "janedoe-tic-tac-toe". Now I need to deploy your code from the GitHub repository. Let me deploy the site:
|
||
|
||
─── netlify-deploy-services | netlify ──────────────────────────
|
||
|
||
selectSchema:<br/>
|
||
operation: deploy-site<br/>
|
||
params:<br/>
|
||
deployDirectory: /Users/janedoe/Development/tic-tac-toe<br/>
|
||
siteId: 1731e49e-1d0a-49a3-ad95-975b550f324a
|
||
|
||
Let me check the deployment status and get the live URL for your site:
|
||
|
||
─── netlify-project-services | netlify ──────────────────────────
|
||
|
||
selectSchema:<br/>
|
||
operation: get-project<br/>
|
||
params:<br/>
|
||
siteId: 1731e49e-1d0a-49a3-ad95-975b550f324a
|
||
</details>
|
||
|
||
🎉 **Success! Your tic-tac-toe game has been deployed to Netlify!**
|
||
|
||
## Deployment Details:
|
||
|
||
- **Live Site URL**: http://janedoe-tic-tac-toe.netlify.app
|
||
- **Netlify Project Dashboard**: https://app.netlify.com/projects/janedoe-tic-tac-toe
|
||
- **Site ID**: 1731e49e-1d0a-49a3-ad95-975b550f324a
|
||
|
||
## What was deployed:
|
||
|
||
✅ **HTML**: Your main game interface
|
||
|
||
✅ **CSS**: Modern styling with animations and responsive design
|
||
|
||
✅ **JavaScript**: Complete game logic and interactivity
|
||
|
||
✅ **README**: Project documentation
|
||
|
||
## Next Steps:
|
||
|
||
1. **Visit your live site**: http://janedoe-tic-tac-toe.netlify.app
|
||
2. **Test the game**: Make sure everything works as expected
|
||
3. **Share with others**: Your game is now live on the web!
|
||
|
||
## Future Updates:
|
||
|
||
Since your code is deployed from your local directory, if you want to make changes:
|
||
|
||
1. Update your local files
|
||
2. Push changes to your GitHub repository
|
||
3. You can either:
|
||
- Redeploy manually using the same command
|
||
- Set up continuous deployment from GitHub (which would auto-deploy when you push changes)
|
||
|
||
Would you like me to help you set up continuous deployment from your GitHub repository so that future changes are automatically deployed?
|
||
|
||
Your tic-tac-toe game is now live and ready to play! 🎮 |