mirror of
https://github.com/aljazceru/goose.git
synced 2025-12-18 06:34:26 +01:00
docs: adding Netlify mcp tutorial (#3165)
This commit is contained in:
Anthony Giuliano
287
documentation/docs/mcp/netlify-mcp.md
Normal file
287
documentation/docs/mcp/netlify-mcp.md
Normal file
@@ -0,0 +1,287 @@
|
||||
---
|
||||
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/izoQatKtJ2I" /> -->
|
||||
|
||||
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
|
||||
└
|
||||
```
|
||||
|
||||
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! 🎮
|
||||
Reference in New Issue
Block a user