Herramienta MCP
Establecer proyecto activo
sosoapi_set_active_projectEstablece el proyecto activo del usuario (un valor predeterminado del servidor).
Leer en MarkdownPerfiles y transportes
Perfiles: full · Transportes: stdio, http
Elige core o full para controlar qué herramientas ve tu cliente; no cambia sus permisos. La carga de archivos locales requiere stdio y no está disponible por HTTP. Establece SOSOAPI_OUTPUT_SCHEMAS=1 para incluir esquemas de salida en la detección. Las herramientas devuelven resultados estructurados con o sin esa opción.
Permisos y efectos secundarios
Las anotaciones ayudan a los clientes a describir una herramienta. Cada llamada sigue comprobando la autenticación, el rol, el acceso al recurso y los permisos de capacidades del usuario.
{
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}- /studio-api/projects/set-active: agent:operate · synchronous_http_response
Campos de entrada
Obligatorio significa obligatorio dentro del objeto principal y la rama elegida. Un campo secundario obligatorio no convierte en obligatorio un objeto principal opcional. Las reglas y nombres de campos siguientes se copian del contrato.
| Campo / rama | Tipo / obligatorio | Restricciones |
|---|---|---|
$ | objectObligatorio en el objeto principal |
|
project_id | stringObligatorio en el objeto principal |
|
JSON Schema completo
{
"type": "object",
"properties": {
"project_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"project_id"
],
"additionalProperties": false
}Salida estructurada
Este esquema describe structuredContent en un resultado exitoso de herramienta. La respuesta MCP también incluye content y puede establecer isError si falla una llamada. Para publicación, consulta el resultado final de la publicación en vez de considerar una solicitud aceptada o una respuesta de texto como confirmación. La operación API enlazada explica los permisos y las reglas de reintento.
Obligatorio significa obligatorio dentro del objeto principal y la rama elegida. Un campo secundario obligatorio no convierte en obligatorio un objeto principal opcional. Las reglas y nombres de campos siguientes se copian del contrato.
| Campo / rama | Tipo / obligatorio | Restricciones |
|---|---|---|
$ | objectObligatorio en el objeto principal |
|
ok | booleanObligatorio en el objeto principal |
|
active_project_id | stringObligatorio en el objeto principal |
|
JSON Schema completo
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"active_project_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"ok",
"active_project_id"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Ejemplo de llamada a herramienta
Estos ejemplos usan valores ficticios comprobados con los esquemas. Sustituye los IDs por otros autorizados, los archivos multimedia por recursos listos y las fechas por tu hora de publicación confirmada. Comprueba la elegibilidad de la cuenta antes de enviar una escritura. Esta página no envía solicitudes API.
{
"name": "sosoapi_set_active_project",
"arguments": {
"project_id": "11111111-1111-4111-8111-111111111111"
}
}structuredContent
{
"ok": true,
"active_project_id": "11111111-1111-4111-8111-111111111111"
}