How it worksFeaturesDocsEarly accessGitHubDashboard

Como integrar Sharetribe Marketplace API usando MCP

Marketplace listings, user flows and transactions. Este guia cria um servidor MCP a partir do template Sharetribe Marketplace API do Arthur — ferramentas pré-configuradas contra https://flex-api.sharetribe.com — e termina compartilhando a documentação swagger MCP do servidor.

Passos

  1. Abra o Cofre de segredos e crie um segredo chamado CHAVE_SHARETRIBE_MARKETPLACE com a sua token de acesso. Use an access token in the Authorization header. Obtain it through the Sharetribe Authentication API or the Sharetribe SDK; some endpoints accept anonymous tokens, while others require an authenticated user token.

    Abra o Cofre de segredos para guardar a credencial do Sharetribe Marketplace API antes de usar o template

    Inicie o assistente Novo segredo

    Nomeie o segredo como CHAVESHARETRIBEMARKETPLACE — os servidores o referenciam por esse nome

  2. Acesse a galeria REST API Templates e busque por Sharetribe Marketplace API.

    Registre a finalidade da credencial para reconhecê-la depois

    Continue para a etapa do valor protegido

  3. Clique em Usar template no card Sharetribe Marketplace API para abrir o diálogo de criação de servidor.

    Informe o valor da credencial — aqui um valor de demonstração; use sua chave real ao adotar a integração

    Revise a sintaxe de referência gerada para o segredo

  4. Revise o nome do servidor e selecione CHAVE_SHARETRIBE_MARKETPLACE no campo de credencial — o diálogo só aceita secrets do cofre, e lista todas as ferramentas que serão criadas.

    Armazene o segredo CHAVESHARETRIBEMARKETPLACE no cofre

    Abra a galeria de templates de API REST

    Busque a integração Sharetribe Marketplace API na galeria

    Abra o template Sharetribe Marketplace API com suas ferramentas pré-configuradas

    Nomeie o servidor com o nome da integração que ele oferece

    Escolha o segredo CHAVESHARETRIBEMARKETPLACE nas sugestões do cofre

    Selecione a credencial armazenada

  5. Clique em Criar servidor. O Arthur cria o servidor, aplica a autenticação e gera todas as ferramentas.

  6. Abra a aba Ferramentas do servidor para revisar as ferramentas geradas.

    Crie o servidor Sharetribe Marketplace API com as ferramentas pré-configuradas

    Revise as ferramentas geradas a partir do template Sharetribe Marketplace API

  7. Abra a seção Conectar do servidor e clique em Compartilhar com cliente — o Arthur gera o link público da documentação swagger e o QR code deste servidor.

    Abra a seção Conectar do servidor, onde ficam o endpoint MCP e sua documentação

    Abra o painel de compartilhamento da documentação swagger MCP

    Mostre o link da documentação swagger e o QR code gerados para este servidor

Confirme que funcionou

O servidor aparece com 7 ferramenta(s) pré-configurada(s): query_listings, show_listing, query_own_listings, create_draft_listing, update_listing, publish_draft_listing, initiate_transaction. A seção Conectar oferece a documentação swagger MCP — uma página compartilhável com instruções de configuração para qualquer cliente de IA.

Bom saber

  • Build the end-user marketplace experience with Sharetribe's Marketplace API. Browse and inspect listings, manage the authenticated user's own listings, publish drafts, and start transactions with bearer access tokens.
  • Esta integração exige uma credencial (bearer).
  • Documentação oficial da API: https://www.sharetribe.com/api-reference/marketplace.html
  • Editar uma ferramenta depois nunca altera o template — templates são pontos de partida, e o servidor é totalmente seu após a criação.

Relacionado

Vídeo tutorial