Lorem Picsum

Lorem Picsum · MCP + OAuth 2.1Ligue o seu assistente de IA ao Picsum

Pesquise fotografias CC0 e crie ligações para imagens no Claude Code, Codex ou Grok Bot através de MCP e OAuth.

https://picsum.org/mcp
  • Claude Code
  • Codex
  • Grok Bot

Escolha o seu assistente

Claude Code

  1. 1
    Adicione o servidor.
    Terminal
    claude mcp add --transport http picsum https://picsum.org/mcp
  2. 2
    No Claude Code, execute /mcp, selecione picsum e escolha Authenticate. Autorize a ligação no navegador.
  3. 3
    Procura três fotografias de café no Picsum e gera elementos img de 800 × 600.

Codex

  1. 1
    Adicione o servidor.
    Terminal
    codex mcp add picsum --url https://picsum.org/mcp
  2. 2
    Inicie sessão com OAuth.
    Terminal
    codex mcp login picsum
    Para iniciar sessão num servidor MCP remoto, precisa de uma versão recente da CLI do Codex. Também pode acrescentar esta linha à secção [mcp_servers.picsum], no ficheiro ~/.codex/config.toml.url = "https://picsum.org/mcp"
  3. 3
    Preenche esta grelha com fotografias aleatórias de comida do Picsum.

Grok Bot

  1. 1
    Nas definições das ferramentas do bot, adicione um servidor MCP remoto com estes dados.
    Definições
    Name: picsum
    URL: https://picsum.org/mcp
    Transport: Streamable HTTP
    Auth: OAuth
  2. 2
    Inicie sessão quando o bot o pedir. O bot encontra os pontos finais OAuth e regista automaticamente o cliente.
  3. 3
    Os nomes dos menus podem variar. Pode ligar outros clientes MCP que suportem OAuth com registo dinâmico.

Demonstração em 60 segundos (em inglês)

O que o assistente pode fazer

search_photos

Pesquisa fotografias CC0 por etiqueta e categoria. Os resultados são divididos em páginas e incluem ligações prontas a usar.

get_photo

Consulta o autor, a descrição, as etiquetas, as dimensões, a fonte e a licença a partir do ID da fotografia.

list_categories

Mostra os identificadores e nomes das categorias, organizados como na página inicial.

build_image_url

Gera um URL e um elemento img nas dimensões indicadas. Suporta valor inicial, categoria, tons de cinzento, desfocagem e WebP.

Acesso só de leitura

  • O assistente pesquisa o catálogo público de fotografias CC0 e cria ligações. Não pode consultar nem alterar os seus ficheiros ou a sua conta.
  • A ferramenta pode consultar fotografias e criar endereços de imagem. Não pode alterar a sua conta.
  • Antes de estabelecer a ligação, a página de consentimento identifica a aplicação que pede acesso.
  • Pode desligar o assistente em qualquer altura, removendo o servidor das definições. Os tokens expiram passada uma hora e podem ser renovados durante um máximo de 30 dias.
  • O OAuth 2.1 exige PKCE. O cliente regista-se dinamicamente, sem precisar de copiar um segredo.

Pontos finais

Servidor MCP
https://picsum.org/mcp
Metadados do recurso
https://picsum.org/.well-known/oauth-protected-resource
Servidor de autorização
https://picsum.org/.well-known/oauth-authorization-server
Página de consentimento
https://picsum.org/connect/authorize
Ponto final de tokens
https://picsum.org/api/auth/mcp/token
Registo do cliente
https://picsum.org/api/auth/mcp/register