> ## Documentation Index
> Fetch the complete documentation index at: https://docs.niadra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP

> As sete ferramentas por Streamable HTTP, com o cliente amarrado pelo subject_token.



## OpenAPI

````yaml openapi/pt/cell.json POST /mcp
openapi: 3.1.0
info:
  title: API de dados da Niadra
  version: '1'
  description: >-
    Escrita, contexto, histórico, objetos, identidade, privacidade e governança
    de um espaço. Cada espaço tem um endereço estável, com o espaço e a região
    no nome.
servers:
  - url: https://{space}.{region}.api.niadra.com
    variables:
      space:
        default: acme-prod
        description: O espaço, que vem na chave de fonte.
      region:
        default: us-east-1
        description: A região do espaço, que também vem na chave.
security: []
paths:
  /mcp:
    post:
      tags:
        - mcp
      summary: Servidor MCP
      description: >-
        O servidor MCP remoto do espaço, por Streamable HTTP com JSON-RPC 2.0.
        Autentique com a chave da fonte e amarre o cliente com o cabeçalho
        `Niadra-Subject-Token`, emitido por `POST /v1/subject-tokens`. Ele serve
        sete ferramentas (`get_customer_context`, `track_event`,
        `record_action`, `resolve_identity`, `search_customer_history`,
        `get_customer_timeline`, `open_history_item`), o recurso
        `niadra://context` e prompts. Cada ferramenta exige o próprio escopo, e
        nenhuma recebe o cliente como argumento.


        **Autenticação.** Chave de fonte e o cabeçalho `Niadra-Subject-Token`.
        Cada ferramenta exige o escopo dela: `context`, `track`, `act`,
        `identify` ou `search`.
      operationId: mcp_mcp_post
      responses:
        '200':
          content:
            application/json:
              schema: {}
          description: >-
            A resposta JSON-RPC. Falha de ferramenta volta como resultado com
            `isError`, não como erro HTTP.
      security:
        - sourceKey: []
          subjectToken: []
components:
  securitySchemes:
    sourceKey:
      type: http
      scheme: bearer
      description: nia_sk_...
    subjectToken:
      type: apiKey
      in: header
      name: Niadra-Subject-Token

````