Skip to main content

Pieces for Developers Extension

This tutorial covers how to add the Pieces for Developers MCP Server as a Goose extension to enable interaction with your Pieces Long-Term Memory.

Configuration​

  1. Download PiecesOS

  2. Enable Long-Term Memory Context in PiecesOS

  3. Locate your MCP Server URL

    • In PiecesOS, navigate to Settings > Model Context Protocol (MCP)
    • Copy the server URL
tip

The default server URL is shown below. PiecesOS may use a different port if 39300 is already in use on your system:

http://localhost:39300/model_context_protocol/2024-11-05/sse

Add Pieces MCP Server​

  1. Run the configure command:

    goose configure

  2. Choose to add a Remote Extension

      ┌   goose-configure 
      │
      ◇  What would you like to configure?
      │  Add Extension 
      │
      ◆  What type of extension would you like to add?
      │  ○ Built-in Extension 
      │  ○ Command-line Extension (Run a local command or script)
      │  ● Remote Extension 
      └

  3. Give your extension a name

      ┌   goose-configure 
      │
      ◇  What would you like to configure?
      │  Add Extension 
      │
      ◇  What type of extension would you like to add?
      │  Remote Extension 
      │
      ◆  What would you like to call this extension?
      │  Pieces
      └

  4. Enter the SSE endpoint URI.

    info

    Use the server URL you copied from PiecesOS settings earlier.

      ┌   goose-configure 
      │
      ◇  What would you like to configure?
      │  Add Extension 
      │
      ◇  What type of extension would you like to add?
      │  Remote Extension 
      │
      ◇  What would you like to call this extension?
      │  Pieces
      │
      ◆  What is the SSE endpoint URI?
      │  http://localhost:39300/model_context_protocol/2024-11-05/sse
      └

  5. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s

      ┌   goose-configure 
      │
      ◇  What would you like to configure?
      │  Add Extension 
      │
      ◇  What type of extension would you like to add?
      │  Remote Extension 
      │
      ◇  What would you like to call this extension?
      │  Pieces
      │
      ◇  What is the SSE endpoint URI?
      │  http://localhost:39300/model_context_protocol/2024-11-05/sse
      │
      ◆  Please set the timeout for this tool (in secs):
      │  300
      └

  6. Add a description if you want, otherwise to leave the description blank select No.

      ┌   goose-configure 
      │
      ◇  What would you like to configure?
      │  Add Extension 
      │
      ◇  What type of extension would you like to add?
      │  Remote Extension 
      │
      ◇  What would you like to call this extension?
      │  Pieces
      │
      ◇  What is the SSE endpoint URI?
      │  http://localhost:39300/model_context_protocol/2024-11-05/sse
      │
      ◇  Please set the timeout for this tool (in secs):
      │  300
      ◆  Would you like to add a description?
      │  ○ Yes  / ● No 
      └

  7. No environment variables are needed, so select No.

      ┌   goose-configure 
      │
      ◇  What would you like to configure?
      │  Add Extension 
      │
      ◇  What type of extension would you like to add?
      │  Remote Extension 
      │
      ◇  What would you like to call this extension?
      │  Pieces
      │
      ◇  What is the SSE endpoint URI?
      │  http://localhost:39300/model_context_protocol/2024-11-05/sse
      │
      ◇  Please set the timeout for this tool (in secs):
      │  300
      ◇  Would you like to add a description?
      │  No 
      │
      ◆  Would you like to add environment variables?
      │  ○ Yes  / ● No 
      └

Example Usage​

Let's use the Pieces for Developers MCP server to generate a status update for a standup meeting based on your activities on the previous day.

Goose Prompt​

I need a status update for what I was using yesterday. Create a report with 5 bullet points based off the most important activities, and give each one a brief description.

Goose Output​

Here's a report summarizing your key activities from yesterday, based on the most important interactions and applications you were using:

1. Code Development with Goose:

    Activity: You worked on integrating SSE MCP servers into the Goose CLI, making enhancements to handle extensions via schema URLs.
    Description: This task involved modifying code and testing new integrations to support advanced functionalities. It also included interactions with the Goose community on Discord for feedback and troubleshooting.

2. Documentation Updates:

    Activity: You updated and managed documentation related to the Goose project and MCP integrations.
    Description: This involved preparing documentation for new features, including usage guidelines and technical details, aiding in the improvement of user experience and technical instructions.

3. Community Interaction on Discord:

  Activity: Engaged with the Block Open Source Community to discuss project developments and potential collaborations.
  Description: You actively participated in community discussions, exchanging insights on project enhancements, and exploring collaborative opportunities with other developers and contributors.

4. Managing and Testing Extensions:

    Activity: You focused on testing and managing various extensions through the Goose platform.
    Description: This included configuring and validating different extensions, ensuring their compatibility and functionality, and incorporating feedback from testing.

5. Content and Integration Planning:

    Activity: Planned integration workflows for MCP and documented their use cases.
    Description: You worked on strategies for implementing MCP integrations effectively, involving planning sessions to optimize future project deployments and align them with user requirements and project objectives.
    
These activities demonstrate a productive day with a focus on development, collaboration, and content management within your technical community.
tip

For more examples of prompts you can use with the Pieces for Developers MCP Server, see the Pieces MCP prompting guide.