# Iniciar OAuth de Threads

URL canónica: https://sosoapi.ai/es/docs/mcp/start-threads-oauth

`sosoapi_start_threads_oauth`

Obtiene la authorize_url del proveedor que una persona debe abrir para conectar una cuenta de Threads. Proporciona workspace_id. No se conecta nada hasta que la persona lo aprueba y confirma en el navegador.

## Perfiles 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.

```json
{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}
```

`/oauth-api/threads/init` — agent:operate; synchronous_http_response

## Campos de entrada

```json
{
  "type": "object",
  "properties": {
    "redirect_to": {
      "type": "string",
      "format": "uri"
    },
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "expected_platform_user_id": {
      "type": "string",
      "minLength": 1
    },
    "interaction_mode": {
      "type": "string",
      "enum": [
        "connect",
        "request_scopes",
        "switch_account",
        "recover"
      ]
    }
  },
  "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.

```json
{
  "type": "object",
  "properties": {
    "authorize_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "authorize_url"
  ],
  "$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.

```json
{
  "name": "sosoapi_start_threads_oauth",
  "arguments": {}
}
```

structuredContent

```json
{
  "authorize_url": "https://example.com/media.png"
}
```

## Operaciones API subyacentes

- [/oauth-api/threads/init](https://sosoapi.ai/es/docs/api/oauth-api-threads-init)