Agentes IA

Agentes de IA conectados por el servidor MCP (OAuth). El panel los aprueba y los desconecta; los agentes usan https://api.marsial.dev/mcp.

Ver quién pide acceso

GET/v1/oauth/requests/{id}

Solo desde el panel. El id llega en el parámetro request de la página de permiso; las solicitudes duran 10 minutos.

Parámetros

idstringobligatorio

Respuesta 200

data

clientNamestringobligatorio
El nombre con el que se registró el agente.
redirectHoststringobligatorio
Adónde vuelve el usuario después de decidir.
workspaceNamestringobligatorio

curl "https://api.marsial.dev/v1/oauth/requests/authz_…" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

const res = await fetch('https://api.marsial.dev/v1/oauth/requests/authz_…', {
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.marsial.dev/v1/oauth/requests/authz_…",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)
data = res.json()["data"]

Dejar entrar al agente

POST/v1/oauth/requests/{id}/approve

Solo desde el panel. El agente actúa como quien lo aprueba, con su rol, hasta que se desconecte.

Parámetros

idstringobligatorio

Respuesta 200

data

redirectTostringobligatorio
Manda el navegador aquí: el agente recibe un código o un error.

curl -X POST "https://api.marsial.dev/v1/oauth/requests/authz_…/approve" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

const res = await fetch('https://api.marsial.dev/v1/oauth/requests/authz_…/approve', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.post(
    "https://api.marsial.dev/v1/oauth/requests/authz_…/approve",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)
data = res.json()["data"]

Rechazar al agente

POST/v1/oauth/requests/{id}/deny

Solo desde el panel.

Parámetros

idstringobligatorio

Respuesta 200

data

redirectTostringobligatorio
Manda el navegador aquí: el agente recibe un código o un error.

curl -X POST "https://api.marsial.dev/v1/oauth/requests/authz_…/deny" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

const res = await fetch('https://api.marsial.dev/v1/oauth/requests/authz_…/deny', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.post(
    "https://api.marsial.dev/v1/oauth/requests/authz_…/deny",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)
data = res.json()["data"]

Listar los agentes conectados

GET/v1/oauth/grants

Solo desde el panel.

Respuesta 200

data []

idstringobligatorio
clientNamestringobligatorio
createdAtstring (date-time)obligatorio
lastUsedAtstring (date-time)
El último día que el agente llamó a Marsial.
yoursbooleanobligatorio
Si lo dejó entrar quien llama.

curl "https://api.marsial.dev/v1/oauth/grants" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

const res = await fetch('https://api.marsial.dev/v1/oauth/grants', {
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.marsial.dev/v1/oauth/grants",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)
data = res.json()["data"]

Desconectar un agente

DELETE/v1/oauth/grants/{id}

Solo desde el panel. Sus tokens dejan de funcionar al momento. Cada miembro desconecta los suyos; propietarios y admins, cualquiera.

Parámetros

idstringobligatorio

Respuesta 204

Sin contenido

curl -X DELETE "https://api.marsial.dev/v1/oauth/grants/grt_5k2j8h" \
  -H "Authorization: Bearer $MARSIAL_API_KEY"

await fetch('https://api.marsial.dev/v1/oauth/grants/grt_5k2j8h', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.MARSIAL_API_KEY}`,
  },
});

import os, requests

requests.delete(
    "https://api.marsial.dev/v1/oauth/grants/grt_5k2j8h",
    headers={"Authorization": f"Bearer {os.environ['MARSIAL_API_KEY']}"},
)